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.

Cargando el índice de búsqueda…

Comprobantes de proveedores

Objetos

SupplierBill

  • idintegerobligatorio

    ID del registro, único entre los registros de su tipo en la tienda.

  • versionintegerobligatorio

    Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match.

  • kindstringobligatorio

    invoice: 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
  • statusstringobligatorio

    draft: 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
  • fiscalbooleanobligatorio

    false: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota.

  • legal_entity_idintegerobligatorio

    ID de la razón social compradora de la tienda (/v1/legal-entities).

  • supplier_idintegerobligatorio

    ID del proveedor (/v1/suppliers).

  • related_bill_idinteger o nullobligatorio

    ID del comprobante que corrige la nota; null en una factura y en una nota sin referencia.

  • numberstring o nullobligatorio

    Número del comprobante como lo cargó la tienda; null en una deuda sin factura.

  • issued_onstring (date)obligatorio

    Fecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda.

  • tax_periodstringobligatorio

    Período fiscal en el que el comprobante va al libro de compras, YYYY-MM.

  • due_onstring (date) o nullobligatorio

    Vencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento.

  • currencystringobligatorio

    Moneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total.

  • exchange_ratestring o nullobligatorio

    Cotizació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_taxedintegerobligatorio

    Neto gravado de IVA.

  • net_exemptintegerobligatorio

    Importe exento de IVA.

  • net_untaxedintegerobligatorio

    Importe no gravado de IVA.

  • tax_totalintegerobligatorio

    IVA del comprobante.

  • perceptions_totalintegerobligatorio

    Percepciones: importes que el proveedor sumó al pago a cuenta de impuestos futuros de la tienda.

  • other_taxes_totalintegerobligatorio

    Impuestos internos y otros tributos del comprobante.

  • totalintegerobligatorio

    Total del comprobante: neto, impuestos y percepciones.

  • base_totalintegerobligatorio

    Total en la moneda de la tienda a la cotización del comprobante.

  • paid_totalintegerobligatorio

    Cuá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.

  • outstandingintegerobligatorio

    Parte 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 nullobligatorio

    IVA 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
    • regimestringobligatorio

      Qué 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
    • kindstringobligatorio

      taxed — 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_bpsintegerobligatorio

      Alícuota en puntos básicos: 2100 es 21 %.

    • baseintegerobligatorio

      Base imponible, sin el impuesto. Los precios incluyen impuestos: base + amount es lo que pagó el cliente por esta parte.

    • amountintegerobligatorio

      Importe 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 nullobligatorio

      Provincia o municipio para los impuestos que lo requieren (turnover, municipal); si no, null.

  • additional_taxesarray de objectobligatorio

    Impuestos además del IVA: percepciones, retenciones, internos y otros. El comprobante solo trae su importe, sin base ni alícuota.

    Campos · 5
    • kindstringobligatorio

      perception: 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
    • regimestringobligatorio

      Qué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros.

      Valores:
      vatincometurnovermunicipalinternalsocialother
    • jurisdictionstring o nullobligatorio

      Jurisdicción del impuesto, por ejemplo la provincia de Ingresos Brutos; null si el impuesto no la necesita.

    • amountintegerobligatorio

      Importe del impuesto.

    • certificate_numberstring o nullobligatorio

      Número del certificado de retención o percepción; null si no hay.

  • linesarray de objectobligatorio

    Líneas del comprobante en orden; un comprobante cargado por totales no tiene líneas.

    Campos · 8
    • descriptionstringobligatorio

      Descripción de la línea como en el comprobante.

    • variant_idinteger o nullobligatorio

      ID de la variante del producto (/v1/variants); null en una línea que no es de un producto.

    • quantitystring o nullobligatorio

      Cantidad como cadena decimal; null si no figura.

    • unit_amountinteger o nullobligatorio

      Precio unitario sin impuestos; null si no figura.

    • net_amountintegerobligatorio

      Importe de la línea sin impuestos.

    • tax_kindstringobligatorio

      taxed: gravado a una alícuota; exempt: exento; untaxed: no gravado.

      Valores:
      taxedexemptuntaxed
    • rate_bpsintegerobligatorio

      Alícuota de IVA en puntos básicos: 2100 es 21 %.

    • tax_amountintegerobligatorio

      IVA de la línea.

  • vendorobjectobligatorio

    Datos del proveedor como figuran en el comprobante: no cambian si después se corrige la ficha del proveedor.

    Campos · 2
    • tax_idstring o nullobligatorio

      Número fiscal del proveedor en el comprobante; null si no figura.

    • legal_namestring o nullobligatorio

      Razón social del proveedor en el comprobante; null si no figura.

  • goods_receipt_idinteger o nullobligatorio

    ID de la recepción que generó esta deuda por entrega; null si el comprobante no lo generó una recepción.

  • goods_receipt_idsarray de integerobligatorio

    Recepciones 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 integerobligatorio

    Devoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns).

  • consignment_settlement_idinteger o nullobligatorio

    ID de la liquidación de consignación por la que se emitió el comprobante; null en los demás.

  • match_statusstringobligatorio

    Control 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 nullobligatorio

    Nota del personal; null si no hay.

  • approved_atstring (date-time) o nullobligatorio

    Cuándo se aprobó el comprobante para pago; null si no está aprobado.

  • posted_atstring (date-time) o nullobligatorio

    Cuándo se registró el comprobante; null en un borrador.

  • voided_atstring (date-time) o nullobligatorio

    Cuándo se anuló el comprobante; null si no está anulado.

  • arobject o nullobligatorio

    Datos de ARCA de la factura o nota; null en una deuda por entrega sin factura.

    Campos · 8
    • document_type_codestring o nullobligatorio

      Código de tipo de comprobante de ARCA: 001: factura A; 006: factura B; 011: factura C; null si no figura.

    • point_of_saleinteger o nullobligatorio

      Punto de venta del proveedor; null si no figura.

    • authorization_kindstring o nullobligatorio

      CAE: 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 nullobligatorio

      Código de autorización; null si no figura.

    • authorization_expires_onstring (date) o nullobligatorio

      Vencimiento del código de autorización, YYYY-MM-DD; null si no figura.

    • verification_statusstring o nullobligatorio

      Constatació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 nullobligatorio

      Parte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto.

    • importobject o nullobligatorio

      Importación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local.

      Campos · 9
      • kindstringobligatorio

        goods: importación de bienes con despacho; services: servicios de un prestador del exterior.

        Valores:
        goodsservices
      • customs_declarationstring o nullobligatorio

        Número de despacho de la importación de bienes; null si no se indicó.

      • document_kindstring o nullobligatorio

        Documento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó.

        Valores:
        invoicecontractothernull
      • document_descriptionstring o nullobligatorio

        Descripción del documento de tipo other; null en los demás.

      • provider_tax_idstring o nullobligatorio

        Identificación fiscal del prestador en su país; null si no se indicó.

      • tax_paid_onstring (date) o nullobligatorio

        Fecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó.

      • tax_paid_amountinteger o nullobligatorio

        IVA pagado por la importación de servicios en la moneda del documento; null si no se indicó.

      • payment_referencestring o nullobligatorio

        Identificación del pago del impuesto; null si no se indicó.

      • payment_entity_tax_idstring o nullobligatorio

        CUIT del banco por el que se ingresó el impuesto; null si no se indicó.

  • created_atstring (date-time)obligatorio

    Cuándo se creó el registro.

  • updated_atstring (date-time)obligatorio

    Cuá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

  • limitinteger

    Tamaño de página: hasta 250 registros; 50 por defecto.

    Mínimo:
    1
    Máximo:
    250
  • cursorstring

    Cursor 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_deletedboolean

    true — 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_idinteger

    Solo documentos de este proveedor.

    Mínimo:
    1

Respuestas

200Éxito

application/json

  • dataarray de SupplierBillobligatorio

    Registros de la página.

  • deletedarray de objectobligatorio

    Registros 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
    • idintegerobligatorio

      ID del registro borrado.

    • deleted_atstring (date-time)obligatorio

      Cuándo se borró el registro.

  • next_cursorstring o nullobligatorio

    Cursor de la página siguiente; null en la última.

  • has_morebooleanobligatorio

    true si hay una página siguiente.

  • sync_cursorstring o nullobligatorio

    En 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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl "https://api.saleya.app/v1/supplier-bills" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "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-Keystring

    Clave ú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

  • kindstringobligatorio

    invoice: 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
  • fiscalbooleanobligatorio

    false: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota.

  • legal_entity_idintegerobligatorio

    ID de la razón social compradora de la tienda (/v1/legal-entities).

  • supplier_idintegerobligatorio

    ID del proveedor (/v1/suppliers).

  • related_bill_idinteger o null

    ID del comprobante que corrige la nota; null en una factura y en una nota sin referencia.

  • numberstring o null

    Número del comprobante como lo cargó la tienda; null en una deuda sin factura.

    Largo máximo:
    20
  • issued_onstring (date)obligatorio

    Fecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda.

  • tax_periodstring

    Período fiscal en el que el comprobante va al libro de compras, YYYY-MM.

  • due_onstring (date) o null

    Vencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento.

  • currencystringobligatorio

    Moneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total.

    Valores:
    ARSUSDBRLCLPCOPMXNPENRUB
  • exchange_ratestring o null

    Cotizació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_taxedinteger

    Neto gravado de IVA.

    Mínimo:
    0
    Máximo:
    10000000000
  • net_exemptinteger

    Importe exento de IVA.

    Mínimo:
    0
    Máximo:
    10000000000
  • net_untaxedinteger

    Importe no gravado de IVA.

    Mínimo:
    0
    Máximo:
    10000000000
  • tax_totalinteger

    IVA del comprobante.

    Mínimo:
    0
    Máximo:
    10000000000
  • totalintegerobligatorio

    Total del comprobante: neto, impuestos y percepciones.

    Mínimo:
    0
    Máximo:
    10000000000
  • notestring o null

    Nota del personal; null si no hay.

    Largo máximo:
    2000
  • linesarray de object

    Líneas del comprobante en orden; un comprobante cargado por totales no tiene líneas.

    Máximo de elementos:
    500
    Campos · 8
    • descriptionstringobligatorio

      Descripción de la línea como en el comprobante.

      Largo máximo:
      300
    • variant_idinteger o null

      ID de la variante del producto (/v1/variants); null en una línea que no es de un producto.

    • quantitystring o null

      Cantidad 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 null

      Precio unitario sin impuestos; null si no figura.

      Mínimo:
      0
      Máximo:
      10000000000
    • net_amountintegerobligatorio

      Importe de la línea sin impuestos.

      Mínimo:
      0
      Máximo:
      10000000000
    • tax_kindstringobligatorio

      taxed: gravado a una alícuota; exempt: exento; untaxed: no gravado.

      Valores:
      taxedexemptuntaxed
    • rate_bpsinteger

      Alícuota de IVA en puntos básicos: 2100 es 21 %.

      Mínimo:
      0
      Máximo:
      10000
    • tax_amountinteger

      IVA de la línea.

      Mínimo:
      0
      Máximo:
      10000000000
  • additional_taxesarray de object

    Impuestos 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
    • kindstringobligatorio

      perception: 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
    • regimestringobligatorio

      Qué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros.

      Valores:
      vatincometurnovermunicipalinternalsocialother
    • jurisdictionstring o null

      Jurisdicció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}$
    • amountintegerobligatorio

      Importe del impuesto.

      Mínimo:
      0
      Máximo:
      10000000000
    • certificate_numberstring o null

      Número del certificado de retención o percepción; null si no hay.

      Largo máximo:
      64
  • goods_receipt_idsarray de integer

    Recepciones 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 integer

    Devoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns).

    Máximo de elementos:
    100
  • arobject o null

    Datos de ARCA de la factura o nota; null en una deuda por entrega sin factura.

    Campos · 7
    • document_type_codestring o null

      Có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 null

      Punto de venta del proveedor; null si no figura.

      Mínimo:
      0
      Máximo:
      99999
    • authorization_kindstring o null

      CAE: 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 null

      Código de autorización; null si no figura.

      Largo máximo:
      14
    • authorization_expires_onstring (date) o null

      Vencimiento del código de autorización, YYYY-MM-DD; null si no figura.

    • credit_fiscal_amountinteger o null

      Parte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto.

      Mínimo:
      0
      Máximo:
      10000000000
    • importobject o null

      Importación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local.

      Campos · 9
      • kindstring

        goods: importación de bienes con despacho; services: servicios de un prestador del exterior.

        Valores:
        goodsservices
      • customs_declarationstring o null

        Número de despacho de la importación de bienes; null si no se indicó.

        Largo máximo:
        16
      • document_kindstring o null

        Documento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó.

        Valores:
        invoicecontractothernull
      • document_descriptionstring o null

        Descripción del documento de tipo other; null en los demás.

        Largo máximo:
        20
      • provider_tax_idstring o null

        Identificación fiscal del prestador en su país; null si no se indicó.

        Largo máximo:
        20
      • tax_paid_onstring (date) o null

        Fecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó.

      • tax_paid_amountinteger o null

        IVA 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 null

        Identificación del pago del impuesto; null si no se indicó.

        Largo máximo:
        20
      • payment_entity_tax_idstring o null

        CUIT del banco por el que se ingresó el impuesto; null si no se indicó.

        Largo máximo:
        11

Respuestas

201Creado

Encabezados

  • Idempotent-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true
  • ETagstringobligatorio

    Versión del registro. Mandala en If-Match para cambiar el registro.

    Ejemplo:
    "7"
  • Locationstring (uri)obligatorio

    Direcció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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterinteger

    Segundos 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl -X POST "https://api.saleya.app/v1/supplier-bills" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @body.json
Cuerpo de la solicitud — 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"
    }
  }
}
Ejemplo de respuesta · 201
{
  "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_billintegerobligatorio

    ID del comprobante de proveedor.

Respuestas

200Éxito

Encabezados

  • ETagstringobligatorio

    Versió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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl "https://api.saleya.app/v1/supplier-bills/{supplier_bill}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "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_billintegerobligatorio

    ID del comprobante de proveedor.

Encabezado

  • Idempotency-Keystring

    Clave ú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-Matchstringobligatorio

    ETag 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

  • kindstring

    invoice: 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
  • fiscalboolean

    false: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota.

  • legal_entity_idinteger

    ID de la razón social compradora de la tienda (/v1/legal-entities).

  • supplier_idinteger

    ID del proveedor (/v1/suppliers).

  • related_bill_idinteger o null

    ID del comprobante que corrige la nota; null en una factura y en una nota sin referencia.

  • numberstring o null

    Nú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_periodstring

    Período fiscal en el que el comprobante va al libro de compras, YYYY-MM.

  • due_onstring (date) o null

    Vencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento.

  • currencystring

    Moneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total.

    Valores:
    ARSUSDBRLCLPCOPMXNPENRUB
  • exchange_ratestring o null

    Cotizació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_taxedinteger

    Neto gravado de IVA.

    Mínimo:
    0
    Máximo:
    10000000000
  • net_exemptinteger

    Importe exento de IVA.

    Mínimo:
    0
    Máximo:
    10000000000
  • net_untaxedinteger

    Importe no gravado de IVA.

    Mínimo:
    0
    Máximo:
    10000000000
  • tax_totalinteger

    IVA del comprobante.

    Mínimo:
    0
    Máximo:
    10000000000
  • totalinteger

    Total del comprobante: neto, impuestos y percepciones.

    Mínimo:
    0
    Máximo:
    10000000000
  • notestring o null

    Nota del personal; null si no hay.

    Largo máximo:
    2000
  • linesarray de object

    Líneas del comprobante en orden; un comprobante cargado por totales no tiene líneas.

    Máximo de elementos:
    500
    Campos · 8
    • descriptionstringobligatorio

      Descripción de la línea como en el comprobante.

      Largo máximo:
      300
    • variant_idinteger o null

      ID de la variante del producto (/v1/variants); null en una línea que no es de un producto.

    • quantitystring o null

      Cantidad 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 null

      Precio unitario sin impuestos; null si no figura.

      Mínimo:
      0
      Máximo:
      10000000000
    • net_amountintegerobligatorio

      Importe de la línea sin impuestos.

      Mínimo:
      0
      Máximo:
      10000000000
    • tax_kindstringobligatorio

      taxed: gravado a una alícuota; exempt: exento; untaxed: no gravado.

      Valores:
      taxedexemptuntaxed
    • rate_bpsinteger

      Alícuota de IVA en puntos básicos: 2100 es 21 %.

      Mínimo:
      0
      Máximo:
      10000
    • tax_amountinteger

      IVA de la línea.

      Mínimo:
      0
      Máximo:
      10000000000
  • additional_taxesarray de object

    Impuestos 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
    • kindstringobligatorio

      perception: 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
    • regimestringobligatorio

      Qué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros.

      Valores:
      vatincometurnovermunicipalinternalsocialother
    • jurisdictionstring o null

      Jurisdicció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}$
    • amountintegerobligatorio

      Importe del impuesto.

      Mínimo:
      0
      Máximo:
      10000000000
    • certificate_numberstring o null

      Número del certificado de retención o percepción; null si no hay.

      Largo máximo:
      64
  • goods_receipt_idsarray de integer

    Recepciones 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 integer

    Devoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns).

    Máximo de elementos:
    100
  • arobject o null

    Datos de ARCA de la factura o nota; null en una deuda por entrega sin factura.

    Campos · 7
    • document_type_codestring o null

      Có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 null

      Punto de venta del proveedor; null si no figura.

      Mínimo:
      0
      Máximo:
      99999
    • authorization_kindstring o null

      CAE: 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 null

      Código de autorización; null si no figura.

      Largo máximo:
      14
    • authorization_expires_onstring (date) o null

      Vencimiento del código de autorización, YYYY-MM-DD; null si no figura.

    • credit_fiscal_amountinteger o null

      Parte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto.

      Mínimo:
      0
      Máximo:
      10000000000
    • importobject o null

      Importación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local.

      Campos · 9
      • kindstring

        goods: importación de bienes con despacho; services: servicios de un prestador del exterior.

        Valores:
        goodsservices
      • customs_declarationstring o null

        Número de despacho de la importación de bienes; null si no se indicó.

        Largo máximo:
        16
      • document_kindstring o null

        Documento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó.

        Valores:
        invoicecontractothernull
      • document_descriptionstring o null

        Descripción del documento de tipo other; null en los demás.

        Largo máximo:
        20
      • provider_tax_idstring o null

        Identificación fiscal del prestador en su país; null si no se indicó.

        Largo máximo:
        20
      • tax_paid_onstring (date) o null

        Fecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó.

      • tax_paid_amountinteger o null

        IVA 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 null

        Identificación del pago del impuesto; null si no se indicó.

        Largo máximo:
        20
      • payment_entity_tax_idstring o null

        CUIT del banco por el que se ingresó el impuesto; null si no se indicó.

        Largo máximo:
        11

Respuestas

200Éxito

Encabezados

  • Idempotent-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true
  • ETagstringobligatorio

    Versió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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterinteger

    Segundos 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
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
Cuerpo de la solicitud — 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"
    }
  }
}
Ejemplo de respuesta · 200
{
  "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_billintegerobligatorio

    ID del comprobante de proveedor.

Encabezado

  • Idempotency-Keystring

    Clave ú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-Matchstringobligatorio

    ETag 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-Replayedstring

    true 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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterinteger

    Segundos 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
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_billintegerobligatorio

    ID del comprobante de proveedor.

Query

  • consentobject

    Consentimientos 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_idstring

      El 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_returnsstring

      La 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-Keystring

    Clave ú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-Matchstringobligatorio

    ETag 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-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true
  • ETagstringobligatorio

    Versió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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterinteger

    Segundos 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
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
Cuerpo de la solicitud — body.json
{}
Ejemplo de respuesta · 200
{
  "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_billintegerobligatorio

    ID del comprobante de proveedor.

Encabezado

  • Idempotency-Keystring

    Clave ú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-Matchstringobligatorio

    ETag 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-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true
  • ETagstringobligatorio

    Versió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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterinteger

    Segundos 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/void" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"'
Ejemplo de respuesta · 200
{
  "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_billintegerobligatorio

    ID del comprobante de proveedor.

Encabezado

  • Idempotency-Keystring

    Clave ú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-Matchstringobligatorio

    ETag 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-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true
  • ETagstringobligatorio

    Versió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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterinteger

    Segundos 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/approve" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"'
Ejemplo de respuesta · 200
{
  "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_billintegerobligatorio

    ID del comprobante de proveedor.

Encabezado

  • Idempotency-Keystring

    Clave ú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-Matchstringobligatorio

    ETag 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-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true
  • ETagstringobligatorio

    Versió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-Authenticatestringobligatorio

    Esquema 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-Authenticatestring

    Esquema 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-Afterinteger

    Segundos 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-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos 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

Ejemplo de solicitud
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/revoke-approval" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"'
Ejemplo de respuesta · 200
{
  "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"
}