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.
Antes de reintentar una creación, busca el registro por tu identificador:
POST
/invoice/lookup para facturas y
GET
/customer/getOne para clientes. Una factura o un contacto con un identificador que ya usaste se rechaza, pero un cliente con el mismo external_customer_id se crea otra vez.

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