Guías
API de Savio
Esta API automatiza tus procesos de cuentas por cobrar en Savio: emitir CFDIs, importarlos desde XML y registrar pagos y créditos contra tus facturas.
Elige tu integración
Savio ofrece dos formas de registrar tus facturas. Elige la que corresponda según dónde se timbran tus CFDIs.
| Timbrar CFDIs con Savio | Importar facturas desde XML | |
|---|---|---|
| Quién timbra el CFDI | Savio, en tu nombre | Tú, o tu PAC/ERP actual |
| Certificados CSD requeridos | Sí | No |
| Clientes | Los creas tú | Se crean automáticamente desde el XML |
| Productos | Catálogo opcional | Se leen del XML |
| Empieza aquí | Guía de timbrado | Guía de importación |
Ambos flujos convergen una vez que existe la factura: los pagos y créditos se registran igual en los dos.
Interpretar las respuestas
Los errores se devuelven con un estatus HTTP y un código legible por máquina, para que puedas ramificar por el código y no por el texto del mensaje.
{"error": "Customer not found","errorCode": "CUSTOMER_NOT_FOUND"}
- Envía tus propios identificadores (
external_customer_id,external_invoice_id) al crear, y podrás referenciar cada registro por ellos más adelante sin tener que guardar los IDs numéricos de Savio. - Esos identificadores también hacen los reintentos seguros: reenviar uno que ya usaste devuelve el registro existente en lugar de crear un duplicado.
Siguientes pasos
Empieza por la guía que corresponda a tu caso, o consulta la lista completa de endpoints en la Referencia de la API.
- POST
/customer— crea tus clientes - POST
/invoice— emite y timbra facturas - POST
/invoice/from-cfdi— importa un CFDI ya timbrado