Comprobantes de proveedores
Cuentas a pagar: facturas, notas de débito y crédito, deudas por entregas sin factura, con IVA por alícuota, percepciones y líneas.
Comprobantes de proveedores
Objetos
SupplierBill
idintegerobligatorioID del registro, único entre los registros de su tipo en la tienda.
versionintegerobligatorioVersión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match.
kindstringobligatorioinvoice: factura; debit_note: nota de débito, aumenta la deuda; credit_note: nota de crédito, reduce la deuda (devolución, descuento, corrección). Los importes del comprobante son siempre positivos y el signo lo da kind.
- Valores:
invoicedebit_notecredit_note
statusstringobligatoriodraft: borrador, no entra en la contabilidad; posted: registrado, entra en cuentas a pagar y en el libro de compras y no cambia; void: anulado, no entra en nada.
- Valores:
draftpostedvoid
fiscalbooleanobligatoriofalse: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota.
legal_entity_idintegerobligatorioID de la razón social compradora de la tienda (/v1/legal-entities).
supplier_idintegerobligatorioID del proveedor (/v1/suppliers).
numberstring o nullobligatorioNúmero del comprobante como lo cargó la tienda; null en una deuda sin factura.
issued_onstring (date)obligatorioFecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda.
tax_periodstringobligatorioPeríodo fiscal en el que el comprobante va al libro de compras, YYYY-MM.
due_onstring (date) o nullobligatorioVencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento.
currencystringobligatorioMoneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total.
exchange_ratestring o nullobligatorioCotización de la moneda del comprobante a la de la tienda como cadena decimal; null en un comprobante en la moneda de la tienda.
net_taxedintegerobligatorioNeto gravado de IVA.
net_exemptintegerobligatorioImporte exento de IVA.
net_untaxedintegerobligatorioImporte no gravado de IVA.
tax_totalintegerobligatorioIVA del comprobante.
perceptions_totalintegerobligatorioPercepciones: importes que el proveedor sumó al pago a cuenta de impuestos futuros de la tienda.
other_taxes_totalintegerobligatorioImpuestos internos y otros tributos del comprobante.
totalintegerobligatorioTotal del comprobante: neto, impuestos y percepciones.
base_totalintegerobligatorioTotal en la moneda de la tienda a la cotización del comprobante.
paid_totalintegerobligatorioCuánto se canceló en la moneda del documento: con dinero, compensación, nota de crédito, anticipo, pago del libro o fuera del sistema. Cada cancelación mueve el comprobante en el feed.
outstandingintegerobligatorioParte pendiente en la moneda del documento: total − paid_total. En una nota de crédito, el crédito sin aplicar; negativo si el documento está pagado de más.
tax_linesarray de object o nullobligatorioIVA por alícuota: gravado, exento y no gravado. null: el comprobante no tiene impuesto o no se puede determinar la alícuota de la parte gravada.
Campos · 6
regimestringobligatorioQué impuesto: vat — impuesto al valor agregado (IVA); income — ganancias; turnover — Ingresos Brutos; municipal — tasas municipales; internal — impuestos internos; social — seguridad social; other — otro. El impuesto de una venta es vat: la clase impositiva del producto clasifica el IVA.
- Valores:
vatincometurnovermunicipalinternalsocialother
kindstringobligatoriotaxed — a la alícuota; exempt — exento por ley; untaxed — no gravado. Las líneas exempt y untaxed tienen rate_bps 0 y amount 0: el importe está en base.
- Valores:
taxedexemptuntaxed
rate_bpsintegerobligatorioAlícuota en puntos básicos: 2100 es 21 %.
baseintegerobligatorioBase imponible, sin el impuesto. Los precios incluyen impuestos: base + amount es lo que pagó el cliente por esta parte.
amountintegerobligatorioImporte del impuesto. El impuesto de una venta se calcula por alícuota para todo el pedido, la base redondeada a la unidad más cercana y el impuesto como resto; los ítems y el envío reciben partes de él, así sus líneas suman la línea del pedido.
jurisdictionstring o nullobligatorioProvincia o municipio para los impuestos que lo requieren (turnover, municipal); si no, null.
additional_taxesarray de objectobligatorioImpuestos además del IVA: percepciones, retenciones, internos y otros. El comprobante solo trae su importe, sin base ni alícuota.
Campos · 5
kindstringobligatorioperception: percepción, aumenta el importe a pagar y la tienda la computa; withholding: retención, la tienda la retiene al pagar y la ingresa al fisco, el importe transferido baja; internal: impuestos internos; other: otros tributos.
- Valores:
perceptionwithholdinginternalother
regimestringobligatorioQué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros.
- Valores:
vatincometurnovermunicipalinternalsocialother
jurisdictionstring o nullobligatorioJurisdicción del impuesto, por ejemplo la provincia de Ingresos Brutos; null si el impuesto no la necesita.
amountintegerobligatorioImporte del impuesto.
certificate_numberstring o nullobligatorioNúmero del certificado de retención o percepción; null si no hay.
linesarray de objectobligatorioLíneas del comprobante en orden; un comprobante cargado por totales no tiene líneas.
Campos · 8
descriptionstringobligatorioDescripción de la línea como en el comprobante.
variant_idinteger o nullobligatorioID de la variante del producto (/v1/variants); null en una línea que no es de un producto.
quantitystring o nullobligatorioCantidad como cadena decimal; null si no figura.
unit_amountinteger o nullobligatorioPrecio unitario sin impuestos; null si no figura.
net_amountintegerobligatorioImporte de la línea sin impuestos.
tax_kindstringobligatoriotaxed: gravado a una alícuota; exempt: exento; untaxed: no gravado.
- Valores:
taxedexemptuntaxed
rate_bpsintegerobligatorioAlícuota de IVA en puntos básicos: 2100 es 21 %.
tax_amountintegerobligatorioIVA de la línea.
vendorobjectobligatorioDatos del proveedor como figuran en el comprobante: no cambian si después se corrige la ficha del proveedor.
Campos · 2
tax_idstring o nullobligatorioNúmero fiscal del proveedor en el comprobante; null si no figura.
legal_namestring o nullobligatorioRazón social del proveedor en el comprobante; null si no figura.
goods_receipt_idinteger o nullobligatorioID de la recepción que generó esta deuda por entrega; null si el comprobante no lo generó una recepción.
goods_receipt_idsarray de integerobligatorioRecepciones que cubre el documento (/v1/goods-receipts): entregas conciliadas con la factura o la entrega de una deuda por entrega.
purchase_order_idsarray de integerobligatorioÓrdenes de compra a las que corresponde el documento (/v1/purchase-orders).
supplier_return_idsarray de integerobligatorioDevoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns).
consignment_settlement_idinteger o nullobligatorioID de la liquidación de consignación por la que se emitió el comprobante; null en los demás.
match_statusstringobligatorioControl contra la recepción: unmatched: sin recepción vinculada; matched: vinculada y coincide; flagged: vinculada con diferencias. No bloquea el pago.
- Valores:
unmatchedmatchedflagged
notestring o nullobligatorioNota del personal; null si no hay.
approved_atstring (date-time) o nullobligatorioCuándo se aprobó el comprobante para pago; null si no está aprobado.
posted_atstring (date-time) o nullobligatorioCuándo se registró el comprobante; null en un borrador.
voided_atstring (date-time) o nullobligatorioCuándo se anuló el comprobante; null si no está anulado.
arobject o nullobligatorioDatos de ARCA de la factura o nota; null en una deuda por entrega sin factura.
Campos · 8
document_type_codestring o nullobligatorioCódigo de tipo de comprobante de ARCA: 001: factura A; 006: factura B; 011: factura C; null si no figura.
point_of_saleinteger o nullobligatorioPunto de venta del proveedor; null si no figura.
authorization_kindstring o nullobligatorioCAE: comprobante electrónico; CAEA: código otorgado por período; CAI: talonario impreso; null: sin autorización (por ejemplo, un comprobante del exterior).
- Valores:
CAECAEACAInull
authorization_codestring o nullobligatorioCódigo de autorización; null si no figura.
authorization_expires_onstring (date) o nullobligatorioVencimiento del código de autorización, YYYY-MM-DD; null si no figura.
verification_statusstring o nullobligatorioConstatación del comprobante en ARCA: verified: confirmado; rejected: ARCA no lo reconoce; unavailable: no se pudo constatar; pending: espera la constatación; null: no se constató.
- Valores:
verifiedrejectedunavailablependingnull
credit_fiscal_amountinteger o nullobligatorioParte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto.
importobject o nullobligatorioImportación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local.
Campos · 9
kindstringobligatoriogoods: importación de bienes con despacho; services: servicios de un prestador del exterior.
- Valores:
goodsservices
customs_declarationstring o nullobligatorioNúmero de despacho de la importación de bienes; null si no se indicó.
document_kindstring o nullobligatorioDocumento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó.
- Valores:
invoicecontractothernull
document_descriptionstring o nullobligatorioDescripción del documento de tipo other; null en los demás.
provider_tax_idstring o nullobligatorioIdentificación fiscal del prestador en su país; null si no se indicó.
tax_paid_onstring (date) o nullobligatorioFecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó.
tax_paid_amountinteger o nullobligatorioIVA pagado por la importación de servicios en la moneda del documento; null si no se indicó.
payment_referencestring o nullobligatorioIdentificación del pago del impuesto; null si no se indicó.
payment_entity_tax_idstring o nullobligatorioCUIT del banco por el que se ingresó el impuesto; null si no se indicó.
created_atstring (date-time)obligatorioCuándo se creó el registro.
updated_atstring (date-time)obligatorioCuándo cambió el registro por última vez.
Endpoints
Comprobantes de proveedores: facturas, notas y deudas por entregas sin factura, con impuestos y líneas
get/supplier-bills
Scope: procurement:read
Parámetros
Query
limitintegerTamaño de página: hasta 250 registros; 50 por defecto.
- Mínimo:
- 1
- Máximo:
- 250
cursorstringCursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él.
- Largo máximo:
- 4096
updated_sincestring (date-time)Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor.
- Patrón:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$
include_deletedbooleantrue — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar.
supplier_idintegerSolo documentos de este proveedor.
- Mínimo:
- 1
Respuestas
200Éxito
application/json
Registros de la página.
deletedarray de objectobligatorioRegistros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización.
Campos · 2
idintegerobligatorioID del registro borrado.
deleted_atstring (date-time)obligatorioCuándo se borró el registro.
next_cursorstring o nullobligatorioCursor de la página siguiente; null en la última.
has_morebooleanobligatoriotrue si hay una página siguiente.
sync_cursorstring o nullobligatorioEn la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás.
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
410El cursor de sincronización supera el plazo de conservación de eliminaciones o se emitió antes de restaurar la base de datos
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl "https://api.saleya.app/v1/supplier-bills" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"data": [
{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}
],
"deleted": [
{
"id": 0,
"deleted_at": "2026-01-15T12:00:00Z"
}
],
"next_cursor": "string",
"has_more": true,
"sync_cursor": "string"
}Crear un borrador de comprobante de proveedor
post/supplier-bills
Scope: procurement:write
Parámetros
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
Cuerpo de la solicitud application/json
kindstringobligatorioinvoice: factura; debit_note: nota de débito, aumenta la deuda; credit_note: nota de crédito, reduce la deuda (devolución, descuento, corrección). Los importes del comprobante son siempre positivos y el signo lo da kind.
- Valores:
invoicedebit_notecredit_note
fiscalbooleanobligatoriofalse: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota.
legal_entity_idintegerobligatorioID de la razón social compradora de la tienda (/v1/legal-entities).
supplier_idintegerobligatorioID del proveedor (/v1/suppliers).
numberstring o nullNúmero del comprobante como lo cargó la tienda; null en una deuda sin factura.
- Largo máximo:
- 20
issued_onstring (date)obligatorioFecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda.
tax_periodstringPeríodo fiscal en el que el comprobante va al libro de compras, YYYY-MM.
due_onstring (date) o nullVencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento.
currencystringobligatorioMoneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total.
- Valores:
ARSUSDBRLCLPCOPMXNPENRUB
exchange_ratestring o nullCotización de la moneda del comprobante a la de la tienda como cadena decimal; null en un comprobante en la moneda de la tienda.
- Largo máximo:
- 1000000000000
- Patrón:
^\d{1,14}(\.\d{1,10})?$
net_taxedintegerNeto gravado de IVA.
- Mínimo:
- 0
- Máximo:
- 10000000000
net_exemptintegerImporte exento de IVA.
- Mínimo:
- 0
- Máximo:
- 10000000000
net_untaxedintegerImporte no gravado de IVA.
- Mínimo:
- 0
- Máximo:
- 10000000000
tax_totalintegerIVA del comprobante.
- Mínimo:
- 0
- Máximo:
- 10000000000
totalintegerobligatorioTotal del comprobante: neto, impuestos y percepciones.
- Mínimo:
- 0
- Máximo:
- 10000000000
notestring o nullNota del personal; null si no hay.
- Largo máximo:
- 2000
linesarray de objectLíneas del comprobante en orden; un comprobante cargado por totales no tiene líneas.
- Máximo de elementos:
- 500
Campos · 8
descriptionstringobligatorioDescripción de la línea como en el comprobante.
- Largo máximo:
- 300
variant_idinteger o nullID de la variante del producto (/v1/variants); null en una línea que no es de un producto.
quantitystring o nullCantidad como cadena decimal; null si no figura.
- Largo mínimo:
- 0
- Largo máximo:
- 1000000000000
- Patrón:
^\d{1,14}(\.\d{1,6})?$
unit_amountinteger o nullPrecio unitario sin impuestos; null si no figura.
- Mínimo:
- 0
- Máximo:
- 10000000000
net_amountintegerobligatorioImporte de la línea sin impuestos.
- Mínimo:
- 0
- Máximo:
- 10000000000
tax_kindstringobligatoriotaxed: gravado a una alícuota; exempt: exento; untaxed: no gravado.
- Valores:
taxedexemptuntaxed
rate_bpsintegerAlícuota de IVA en puntos básicos: 2100 es 21 %.
- Mínimo:
- 0
- Máximo:
- 10000
tax_amountintegerIVA de la línea.
- Mínimo:
- 0
- Máximo:
- 10000000000
additional_taxesarray de objectImpuestos además del IVA: percepciones, retenciones, internos y otros. El comprobante solo trae su importe, sin base ni alícuota.
- Máximo de elementos:
- 50
Campos · 5
kindstringobligatorioperception: percepción, aumenta el importe a pagar y la tienda la computa; withholding: retención, la tienda la retiene al pagar y la ingresa al fisco, el importe transferido baja; internal: impuestos internos; other: otros tributos.
- Valores:
perceptionwithholdinginternalother
regimestringobligatorioQué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros.
- Valores:
vatincometurnovermunicipalinternalsocialother
jurisdictionstring o nullJurisdicción del impuesto, por ejemplo la provincia de Ingresos Brutos; null si el impuesto no la necesita.
- Largo máximo:
- 8
- Patrón:
^[A-Z]{2}-[A-Z0-9]{1,5}$
amountintegerobligatorioImporte del impuesto.
- Mínimo:
- 0
- Máximo:
- 10000000000
certificate_numberstring o nullNúmero del certificado de retención o percepción; null si no hay.
- Largo máximo:
- 64
goods_receipt_idsarray de integerRecepciones que cubre el documento (/v1/goods-receipts): entregas conciliadas con la factura o la entrega de una deuda por entrega.
- Máximo de elementos:
- 100
purchase_order_idsarray de integerÓrdenes de compra a las que corresponde el documento (/v1/purchase-orders).
- Máximo de elementos:
- 100
supplier_return_idsarray de integerDevoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns).
- Máximo de elementos:
- 100
arobject o nullDatos de ARCA de la factura o nota; null en una deuda por entrega sin factura.
Campos · 7
document_type_codestring o nullCódigo de tipo de comprobante de ARCA: 001: factura A; 006: factura B; 011: factura C; null si no figura.
- Largo máximo:
- 3
point_of_saleinteger o nullPunto de venta del proveedor; null si no figura.
- Mínimo:
- 0
- Máximo:
- 99999
authorization_kindstring o nullCAE: comprobante electrónico; CAEA: código otorgado por período; CAI: talonario impreso; null: sin autorización (por ejemplo, un comprobante del exterior).
- Valores:
CAECAEACAInull
authorization_codestring o nullCódigo de autorización; null si no figura.
- Largo máximo:
- 14
authorization_expires_onstring (date) o nullVencimiento del código de autorización, YYYY-MM-DD; null si no figura.
credit_fiscal_amountinteger o nullParte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto.
- Mínimo:
- 0
- Máximo:
- 10000000000
importobject o nullImportación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local.
Campos · 9
kindstringgoods: importación de bienes con despacho; services: servicios de un prestador del exterior.
- Valores:
goodsservices
customs_declarationstring o nullNúmero de despacho de la importación de bienes; null si no se indicó.
- Largo máximo:
- 16
document_kindstring o nullDocumento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó.
- Valores:
invoicecontractothernull
document_descriptionstring o nullDescripción del documento de tipo other; null en los demás.
- Largo máximo:
- 20
provider_tax_idstring o nullIdentificación fiscal del prestador en su país; null si no se indicó.
- Largo máximo:
- 20
tax_paid_onstring (date) o nullFecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó.
tax_paid_amountinteger o nullIVA pagado por la importación de servicios en la moneda del documento; null si no se indicó.
- Mínimo:
- 0
- Máximo:
- 10000000000
payment_referencestring o nullIdentificación del pago del impuesto; null si no se indicó.
- Largo máximo:
- 20
payment_entity_tax_idstring o nullCUIT del banco por el que se ingresó el impuesto; null si no se indicó.
- Largo máximo:
- 11
Respuestas
201Creado
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
Locationstring (uri)obligatorioDirección del registro creado; en una solicitud aceptada (202), la dirección donde seguir su resultado.
application/json
Devuelve SupplierBill
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X POST "https://api.saleya.app/v1/supplier-bills" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H "Content-Type: application/json" \
-d @body.json{
"kind": "invoice",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "ARS",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"total": 0,
"note": "string",
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
}
}{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}Comprobante de proveedor
get/supplier-bills/{supplier_bill}
Scope: procurement:read
Parámetros
Ruta
supplier_billintegerobligatorioID del comprobante de proveedor.
Respuestas
200Éxito
Encabezados
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve SupplierBill
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl "https://api.saleya.app/v1/supplier-bills/{supplier_bill}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}Cambiar un borrador de comprobante de proveedor
patch/supplier-bills/{supplier_bill}
Scope: procurement:write
Parámetros
Ruta
supplier_billintegerobligatorioID del comprobante de proveedor.
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Cuerpo de la solicitud application/json
kindstringinvoice: factura; debit_note: nota de débito, aumenta la deuda; credit_note: nota de crédito, reduce la deuda (devolución, descuento, corrección). Los importes del comprobante son siempre positivos y el signo lo da kind.
- Valores:
invoicedebit_notecredit_note
fiscalbooleanfalse: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota.
legal_entity_idintegerID de la razón social compradora de la tienda (/v1/legal-entities).
supplier_idintegerID del proveedor (/v1/suppliers).
numberstring o nullNúmero del comprobante como lo cargó la tienda; null en una deuda sin factura.
- Largo máximo:
- 20
issued_onstring (date)Fecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda.
tax_periodstringPeríodo fiscal en el que el comprobante va al libro de compras, YYYY-MM.
due_onstring (date) o nullVencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento.
currencystringMoneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total.
- Valores:
ARSUSDBRLCLPCOPMXNPENRUB
exchange_ratestring o nullCotización de la moneda del comprobante a la de la tienda como cadena decimal; null en un comprobante en la moneda de la tienda.
- Largo máximo:
- 1000000000000
- Patrón:
^\d{1,14}(\.\d{1,10})?$
net_taxedintegerNeto gravado de IVA.
- Mínimo:
- 0
- Máximo:
- 10000000000
net_exemptintegerImporte exento de IVA.
- Mínimo:
- 0
- Máximo:
- 10000000000
net_untaxedintegerImporte no gravado de IVA.
- Mínimo:
- 0
- Máximo:
- 10000000000
tax_totalintegerIVA del comprobante.
- Mínimo:
- 0
- Máximo:
- 10000000000
totalintegerTotal del comprobante: neto, impuestos y percepciones.
- Mínimo:
- 0
- Máximo:
- 10000000000
notestring o nullNota del personal; null si no hay.
- Largo máximo:
- 2000
linesarray de objectLíneas del comprobante en orden; un comprobante cargado por totales no tiene líneas.
- Máximo de elementos:
- 500
Campos · 8
descriptionstringobligatorioDescripción de la línea como en el comprobante.
- Largo máximo:
- 300
variant_idinteger o nullID de la variante del producto (/v1/variants); null en una línea que no es de un producto.
quantitystring o nullCantidad como cadena decimal; null si no figura.
- Largo mínimo:
- 0
- Largo máximo:
- 1000000000000
- Patrón:
^\d{1,14}(\.\d{1,6})?$
unit_amountinteger o nullPrecio unitario sin impuestos; null si no figura.
- Mínimo:
- 0
- Máximo:
- 10000000000
net_amountintegerobligatorioImporte de la línea sin impuestos.
- Mínimo:
- 0
- Máximo:
- 10000000000
tax_kindstringobligatoriotaxed: gravado a una alícuota; exempt: exento; untaxed: no gravado.
- Valores:
taxedexemptuntaxed
rate_bpsintegerAlícuota de IVA en puntos básicos: 2100 es 21 %.
- Mínimo:
- 0
- Máximo:
- 10000
tax_amountintegerIVA de la línea.
- Mínimo:
- 0
- Máximo:
- 10000000000
additional_taxesarray de objectImpuestos además del IVA: percepciones, retenciones, internos y otros. El comprobante solo trae su importe, sin base ni alícuota.
- Máximo de elementos:
- 50
Campos · 5
kindstringobligatorioperception: percepción, aumenta el importe a pagar y la tienda la computa; withholding: retención, la tienda la retiene al pagar y la ingresa al fisco, el importe transferido baja; internal: impuestos internos; other: otros tributos.
- Valores:
perceptionwithholdinginternalother
regimestringobligatorioQué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros.
- Valores:
vatincometurnovermunicipalinternalsocialother
jurisdictionstring o nullJurisdicción del impuesto, por ejemplo la provincia de Ingresos Brutos; null si el impuesto no la necesita.
- Largo máximo:
- 8
- Patrón:
^[A-Z]{2}-[A-Z0-9]{1,5}$
amountintegerobligatorioImporte del impuesto.
- Mínimo:
- 0
- Máximo:
- 10000000000
certificate_numberstring o nullNúmero del certificado de retención o percepción; null si no hay.
- Largo máximo:
- 64
goods_receipt_idsarray de integerRecepciones que cubre el documento (/v1/goods-receipts): entregas conciliadas con la factura o la entrega de una deuda por entrega.
- Máximo de elementos:
- 100
purchase_order_idsarray de integerÓrdenes de compra a las que corresponde el documento (/v1/purchase-orders).
- Máximo de elementos:
- 100
supplier_return_idsarray de integerDevoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns).
- Máximo de elementos:
- 100
arobject o nullDatos de ARCA de la factura o nota; null en una deuda por entrega sin factura.
Campos · 7
document_type_codestring o nullCódigo de tipo de comprobante de ARCA: 001: factura A; 006: factura B; 011: factura C; null si no figura.
- Largo máximo:
- 3
point_of_saleinteger o nullPunto de venta del proveedor; null si no figura.
- Mínimo:
- 0
- Máximo:
- 99999
authorization_kindstring o nullCAE: comprobante electrónico; CAEA: código otorgado por período; CAI: talonario impreso; null: sin autorización (por ejemplo, un comprobante del exterior).
- Valores:
CAECAEACAInull
authorization_codestring o nullCódigo de autorización; null si no figura.
- Largo máximo:
- 14
authorization_expires_onstring (date) o nullVencimiento del código de autorización, YYYY-MM-DD; null si no figura.
credit_fiscal_amountinteger o nullParte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto.
- Mínimo:
- 0
- Máximo:
- 10000000000
importobject o nullImportación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local.
Campos · 9
kindstringgoods: importación de bienes con despacho; services: servicios de un prestador del exterior.
- Valores:
goodsservices
customs_declarationstring o nullNúmero de despacho de la importación de bienes; null si no se indicó.
- Largo máximo:
- 16
document_kindstring o nullDocumento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó.
- Valores:
invoicecontractothernull
document_descriptionstring o nullDescripción del documento de tipo other; null en los demás.
- Largo máximo:
- 20
provider_tax_idstring o nullIdentificación fiscal del prestador en su país; null si no se indicó.
- Largo máximo:
- 20
tax_paid_onstring (date) o nullFecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó.
tax_paid_amountinteger o nullIVA pagado por la importación de servicios en la moneda del documento; null si no se indicó.
- Mínimo:
- 0
- Máximo:
- 10000000000
payment_referencestring o nullIdentificación del pago del impuesto; null si no se indicó.
- Largo máximo:
- 20
payment_entity_tax_idstring o nullCUIT del banco por el que se ingresó el impuesto; null si no se indicó.
- Largo máximo:
- 11
Respuestas
200Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve SupplierBill
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 409
supplier_bill_refusedEl comprobante de proveedor no acepta este comando - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X PATCH "https://api.saleya.app/v1/supplier-bills/{supplier_bill}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"' \
-H "Content-Type: application/json" \
-d @body.json{
"kind": "invoice",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "ARS",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"total": 0,
"note": "string",
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
}
}{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}Eliminar un borrador de comprobante de proveedor
delete/supplier-bills/{supplier_bill}
Scope: procurement:write
Parámetros
Ruta
supplier_billintegerobligatorioID del comprobante de proveedor.
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Respuestas
204Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
Sin cuerpo
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 409
in_use_conflictRegistro en uso - 409
supplier_bill_refusedEl comprobante de proveedor no acepta este comando - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X DELETE "https://api.saleya.app/v1/supplier-bills/{supplier_bill}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'Registrar un comprobante de proveedor: entra en las cuentas a pagar y el libro de compras
post/supplier-bills/{supplier_bill}/post
Scope: procurement:write
Parámetros
Ruta
supplier_billintegerobligatorioID del comprobante de proveedor.
Query
consentobjectConsentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.
Campos · 2
vendor_tax_idstringEl proveedor mandó el comprobante sin CUIT en su ficha: el registro guarda en la ficha el CUIT de la factura. suppliers indica cuántas fichas cambian.
- Largo mínimo:
- 64
- Largo máximo:
- 64
close_returnsstringLa nota de crédito cubre por completo devoluciones al proveedor: el registro las cierra. supplier_returns indica cuántas devoluciones se cierran.
- Largo mínimo:
- 64
- Largo máximo:
- 64
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Cuerpo de la solicitud application/json
object
Respuestas
200Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve SupplierBill
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
consent_requiredHace falta consentir las consecuencias - 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 409
supplier_bill_refusedEl comprobante de proveedor no acepta este comando - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/post" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"' \
-H "Content-Type: application/json" \
-d @body.json{}{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}Anular un comprobante de proveedor junto con sus pagos y compensaciones
post/supplier-bills/{supplier_bill}/void
Scope: procurement:write
Parámetros
Ruta
supplier_billintegerobligatorioID del comprobante de proveedor.
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Respuestas
200Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve SupplierBill
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 409
supplier_bill_refusedEl comprobante de proveedor no acepta este comando - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/void" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}Aprobar el pago de un comprobante de proveedor registrado
post/supplier-bills/{supplier_bill}/approve
Scope: procurement:approve
Parámetros
Ruta
supplier_billintegerobligatorioID del comprobante de proveedor.
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Respuestas
200Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve SupplierBill
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 409
supplier_bill_refusedEl comprobante de proveedor no acepta este comando - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/approve" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}Revocar la aprobación de pago de un comprobante de proveedor
post/supplier-bills/{supplier_bill}/revoke-approval
Scope: procurement:approve
Parámetros
Ruta
supplier_billintegerobligatorioID del comprobante de proveedor.
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Respuestas
200Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve SupplierBill
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 409
supplier_bill_refusedEl comprobante de proveedor no acepta este comando - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/revoke-approval" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'{
"id": 0,
"version": 0,
"kind": "invoice",
"status": "draft",
"fiscal": true,
"legal_entity_id": 0,
"supplier_id": 0,
"related_bill_id": 0,
"number": "string",
"issued_on": "2026-01-15",
"tax_period": "string",
"due_on": "2026-01-15",
"currency": "string",
"exchange_rate": "string",
"net_taxed": 0,
"net_exempt": 0,
"net_untaxed": 0,
"tax_total": 0,
"perceptions_total": 0,
"other_taxes_total": 0,
"total": 0,
"base_total": 0,
"paid_total": 0,
"outstanding": 0,
"tax_lines": [
{
"regime": "vat",
"kind": "taxed",
"rate_bps": 0,
"base": 0,
"amount": 0,
"jurisdiction": "string"
}
],
"additional_taxes": [
{
"kind": "perception",
"regime": "vat",
"jurisdiction": "string",
"amount": 0,
"certificate_number": "string"
}
],
"lines": [
{
"description": "string",
"variant_id": 0,
"quantity": "string",
"unit_amount": 0,
"net_amount": 0,
"tax_kind": "taxed",
"rate_bps": 0,
"tax_amount": 0
}
],
"vendor": {
"tax_id": "string",
"legal_name": "string"
},
"goods_receipt_id": 0,
"goods_receipt_ids": [
0
],
"purchase_order_ids": [
0
],
"supplier_return_ids": [
0
],
"consignment_settlement_id": 0,
"match_status": "unmatched",
"note": "string",
"approved_at": "2026-01-15T12:00:00Z",
"posted_at": "2026-01-15T12:00:00Z",
"voided_at": "2026-01-15T12:00:00Z",
"ar": {
"document_type_code": "string",
"point_of_sale": 0,
"authorization_kind": "CAE",
"authorization_code": "string",
"authorization_expires_on": "2026-01-15",
"verification_status": "verified",
"credit_fiscal_amount": 0,
"import": {
"kind": "goods",
"customs_declaration": "string",
"document_kind": "invoice",
"document_description": "string",
"provider_tax_id": "string",
"tax_paid_on": "2026-01-15",
"tax_paid_amount": 0,
"payment_reference": "string",
"payment_entity_tax_id": "string"
}
},
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}