¿Puedo usar la misma API Key para pruebas y producción?
Técnicamente sí, pero recomendamos una clave por ambiente. El ambiente SRI (Pruebas vs. Producción) lo define el campo
environmentId del negocio, no la clave.¿Por qué mi API Key vuelve 401 si la acabo de crear?
Verifica que la pegaste tal cual aparece en el panel (sin espacios), que el header se llama
X-API-Key (no Authorization) y que la clave esté activa.¿Cómo indico el tipo de comprobante al crearlo?
Con
document_type_id, el ID que devuelve /catalogs/document-types. Es el único campo que define el tipo; si falta o no existe, recibes un 422 con el detalle del error.¿La API calcula los impuestos por mí?
Sí, para los tipos 01 / 03 / 04 / 05. Envía solo los items y el backend calcula
subtotal, total y taxes. Para los tipos 06 (Guía de Remisión) y 07 (Retención), las reglas son distintas: consulta la página de Documentos.¿Cómo emito una factura en ambiente de pruebas del SRI?
Crea el negocio con
environmentId: 1. Recuerda que las pruebas SRI usan certificados distintos a producción.¿Qué hago si el SRI tarda en autorizar?
Espera unos minutos y llama
PUT /documents/{id} con { "verify": true } para volver a consultar el estado.¿Cómo anulo una factura emitida?
No se elimina. Emite una Nota de Crédito referenciando la factura original, o sigue el proceso formal de anulación ante el SRI.
¿Hay límites de tamaño en los items de un comprobante?
Los límites concretos vienen del SRI. Como regla práctica, no excedas 200 líneas por documento.
¿Cómo subo la firma electrónica?
Con
POST /businesses/{id}/files usando multipart/form-data y los campos sign (.p12) y opcionalmente logo.¿Puedo descargar el RIDE y el XML al mismo tiempo?
No en una sola llamada. Llama dos veces a
GET /documents/{id}/download, una con format=pdf y otra con format=xml.