Consultar facturas

get https://app.aliaddo.net/v1/bills

Query Params

page

int32

required

Defaults to 1

Desde que número de facturas desea consultar. Por ejemplo para consultar desde la factura 10, se envía page=10. Los resultados varian según el orden en el que se muestra la información.

itemsPerPage

int32

required

Defaults to 10

Cantidad de facturas por página. Por defecto retorna 10 facturas. La cantidad máxima de de facturas son 50, si este valor es mayor que 50, la aplicación retorna error.

status

string

Filtrar resultados según el estado de la factura. Se retornarán todas las facturas de venta que coincidan en su estado.

Vigente - Facturas por pagar
Pagada - Facturas con pago total
PagoParcial- Facturas con pago parcial
NotaDebito - Facturas con devolución
NotaDebitoParcial - Facturas con devolución parcial
Invalida - Facturas inválidas

consecutive

string

Filtrar por consecutivo de la factura

personId

string

Filtrar resultados según el identificador (ID) del cliente de la factura. Se retornarán todas las facturas de compra que estén asociadas a un cliente.

personIdSeller

string

Filtrar resultados según el identificador (ID) del vendedor de la factura. Se retornarán todas las facturas de compra que estén asociadas a un vendedor.

itemId

string

Filtrar las facturas de compra por el id del producto.

date

Filtrar resultados según fecha de creación de la factura. Se retornarán todas las facturas de compra que su fecha de creación (atributo date) coincida exactamente con el valor enviado en este parámetro.
FORMATO: YYYY-MM-DD

dueDate

date

Filtrar resultados según fecha de vencimiento de la factura. Se retornarán todas las facturas de compra que coincidan en su fecha de vencimiento (atributo dueDate) con el valor enviado en este parámetro.
FORMATO: YYYY-MM-DD

dateAfter

string

Fecha del documento desde la cual se deben obtener los resultados. Consulta desde la fecha filtrada en adelante
FORMATO: YYYY-MM-DD

dateBefore

string

Fecha del documento desde la cual se deben obtener los resultados. Consulta desde la fecha filtrada para atrás
FORMATO: YYYY-MM-DD

Responses

Response body

array of objects

object

string

enviroment

string

kindCode

string

kindName

string

consecutive

string

branchId

string

branchName

string

branchAddress

string

branchPhone

string

branchPostalCode

string

branchEmail

string

branchCountryCode

string

branchCountryName

string

branchRegionCode

string

branchRegionName

string

branchCityCode

string

branchCityName

string

date

string

dueDate

string

startDate

string

endDate

string

purchaseOrderNumber

string

personId

string

personName

string

personIdentification

string

addressIdBilling

string

observation

string

currencyCode

string

exchangeRate

integer

Defaults to 0

subtotalAmount

integer

Defaults to 0

discountAmount

integer

Defaults to 0

discountAmountDetail

integer

Defaults to 0

discounts

array

discounts

chargeAmount

integer

Defaults to 0

chargeAmountDetail

integer

Defaults to 0

charges

array

charges

taxAmount

integer

Defaults to 0

withholdingAmount

integer

Defaults to 0

withholdingAmountIca

integer

Defaults to 0

withholdingAmountVat

integer

Defaults to 0

adjustAmount

integer

Defaults to 0

roundAmount

integer

Defaults to 0

advanceAmount

integer

Defaults to 0

totalAmount

integer

Defaults to 0

paymentAmount

integer

Defaults to 0

creditNoteAmount

integer

Defaults to 0

debitNoteAmount

integer

Defaults to 0

balanceAmount

integer

Defaults to 0

taxes

array of objects

taxes

object

string

name

string

categoryCode

string

rate

integer

Defaults to 0

rateKind

string

amount

integer

Defaults to 0

withholdings

array of objects

withholdings

object

string

name

string

categoryCode

string

rate

integer

Defaults to 0

rateKind

string

amount

integer

Defaults to 0

costCenterId

string

paymentFormCode

string

paymentMeanCode

string

cuds

string

securityCode

string

resolutionId

string

details

array of objects

details

object

string

billId

string

itemId

string

itemCode

string

itemSerialNumbers

array

itemSerialNumbers

itemBatchCode

string

unitMeasurementId

string

warehouseId

string

personIdMandator

string

isGift

boolean

Defaults to true

description

string

quantity

integer

Defaults to 0

unitValue

integer

Defaults to 0

unitValueBeforeTax

integer

Defaults to 0

subtotalAmount

integer

Defaults to 0

costAmount

integer

Defaults to 0

discountRate

integer

Defaults to 0

discountIsPercent

boolean

Defaults to true

discountAmount

integer

Defaults to 0

taxes

array of objects

taxes

object

string

name

string

categoryCode

string

rate

integer

Defaults to 0

rateKind

string

amount

integer

Defaults to 0

withholdings

array of objects

withholdings

object

string

name

string

categoryCode

string

rate

integer

Defaults to 0

rateKind

string

amount

integer

Defaults to 0

unitMeasurementIdConversion

string

quantityConversion

integer

Defaults to 0

unitValueConversion

integer

Defaults to 0

typeOfOperationCode

string

createdAt

string

status

string

statusDian

string

stateDian

string

stateDianReason

array

stateDianReason

stateDianDate

string

stateDianEventDate

string

stateDianEventCude

string

claimConceptCode

string

claimConceptName

string

Language

Credentials

OAuth2


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://app.aliaddo.net/v1/bills?page=1&itemsPerPage=10' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400