Receipts

Emitir documento tributario

Changed on

Emite el documento tributario que corresponde a una deuda ya pagada y lo asocia a ella.

El documento se emite a través del proveedor de facturación configurado para la cuenta, según el país de la organización: en Chile una boleta o una factura, y en México un CFDI. El tipo de documento se toma de la deuda y, si esta no lo define, del valor por omisión del Customer.

La deuda se identifica por product_id junto con due_date o invoice_external_id. Cuando el documento se emite, queda vinculado a la deuda y se le envía al Customer.

No toda deuda es elegible. La respuesta es 200 —no un error— cuando la emisión se omite, y message explica el motivo: la deuda no existe, no tiene Customer, no registra pago cuando el tipo de documento lo exige, ya tenía un documento emitido, el tipo de documento no corresponde emitirlo, el país de la organización no cuenta con emisión de documentos tributarios, o faltan datos tributarios del Customer o de la organización. Emitido el documento, la respuesta es 201.

post/receipt

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/receipt
  • Auth
    API key in header x-api-key

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

due_datestring nullable

Fecha de vencimiento de la deuda. Solo se usa para construir invoice_external_id cuando este no se envía. Debe enviarse este campo o invoice_external_id; si no se envía ninguno, la petición falla con 422.

invoice_external_idstring nullable

Identificador externo de la deuda, con el que se la busca. Si se omite, se construye como {product_id}-{due_date}.

product_idstring required

Identificador del producto o servicio al que corresponde la deuda.

use_idempotency_keyboolean nullable

Envía una clave de idempotencia al proveedor de facturación, para que un reintento no emita dos documentos. Solo se considera en Chile.

use_transaction_dateboolean nullable

Emite el documento con la fecha del pago en lugar de la fecha de emisión. Solo se considera en Chile.

Example request

{
  "due_date": "2022-02-28",
  "product_id": "test"
}

Response

La deuda no era elegible y no se emitió ningún documento. El motivo viene en message.

messagestring required

Detalle del resultado: la confirmación de que el documento fue emitido, o el motivo por el que la deuda no era elegible y no se emitió ninguno.

Changes