GET
/v1/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.
- 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 / customer
- objeto
- El emisor y el receptor tal como quedaron en el comprobante.
- items
- arreglo
- Las partidas, con su importe y su impuesto trasladado.
- subtotal / total
- string
- Importes con dos decimales, como texto: un float perdería centavos.
- 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.
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.