GET
/v1/mx/invoices/:id
Consultar una factura
La misma forma que devuelve crear una factura, para cuando la quieres volver a leer. Por el id nuestro, no por el UUID.
Es una fotografía, no una vista
El emisor y el receptor salen del comprobante y no de los registros de los que se copiaron. Si tu cliente corrigió su razón social el mes pasado, esta factura sigue diciendo la que llevaba cuando se timbró, porque eso es lo que tiene el SAT y lo que hay que poder reportar.
La respuesta
- id
- entero
- El identificador dentro de oden.tax. Es lo que va en la URL.
- status
- string
- draft, stamping, stamped, error o canceled. Pasa a canceled en cuanto el SAT recibe la solicitud de cancelación, aunque el receptor todavía no la acepte: para saber si el comprobante sigue vigente, lee cancellation.status.
- uuid
- string o null
- El folio fiscal que puso el SAT. Null mientras no haya timbre; la llave siempre está.
- folio
- string
- Serie y número, como "A-1044". Es el nombre que una persona le da a este documento.
- issuer
- objeto
- id, tax_id, legal_name, tax_regime y postal_code, tal como quedaron en el comprobante.
- customer
- objeto
- id, tax_id, legal_name, tax_regime y postal_code, más tax_residency y foreign_tax_id cuando es extranjero.
- items
- arreglo
- Las partidas: product_service_key, unit_key, description, quantity, unit_price, amount y transferred_taxes.
- subtotal / transferred_taxes / withheld_taxes / vat_withheld_taxes / total
- string
- Importes con dos decimales, como texto: un float perdería centavos.
- issued_at / stamped_at / canceled_at
- string o null
- ISO 8601 con zona horaria. canceled_at es cuándo se pidió la cancelación.
- xml_url / pdf_url
- string
- Sólo cuando hay comprobante. Son estables: puedes guardarlas.
- error
- objeto
- Sólo en una factura rechazada, con el code estable y el motivo.
- cancellation
- objeto
- Sólo si se pidió cancelarla: status, reason y substitute_uuid. status es requested mientras el receptor no contesta y el comprobante sigue vigente. accepted o final, cuando el SAT ya la canceló. rejected, cuando el receptor la rechazó y el comprobante sigue vigente. unknown, en una solicitud de hace más de 30 días de la que nunca supimos la respuesta: consúltala en el SAT.
La respuesta completa, campo por campo, está en crear una factura. Para enterarte de un cambio sin consultar, webhooks.
Errores
not_found
si esa factura no es de tu cuenta o no existe. Contestamos igual a las dos
cosas a propósito: distinguirlas diría si un id ajeno existe.