Apariencia
Introducción
El API de Facturación de CG Imprenta Digital permite que tu sistema emita y consulte documentos fiscales digitales sin entrar al panel web. Cada documento emitido por el API recibe su número de control, queda firmado electrónicamente y se puede descargar en PDF, igual que si se hubiera emitido desde el panel.
Qué puedes hacer
| Área | Operaciones |
|---|---|
| Autenticación | Solicitar token |
| Documentos fiscales | Factura, factura a terceros, nota de crédito (total o parcial), nota de débito, orden de entrega (individual), guía de despacho (opcional) |
| Retenciones | IVA, ISLR, consulta de IVA e ISLR, códigos ISLR, anulación |
| Productos y clientes | Registrar productos, registrar clientes, consultar clientes |
| Consultas | Métodos de pago, bancos, facturas emitidas |
| Operaciones | Enviar documento por correo, anular factura |
Antes de empezar
- Cuenta habilitada para el API. CG Imprenta Digital te entrega el usuario y la contraseña de API del negocio emisor. El negocio debe tener números de control disponibles y su certificado de firma vigente; si no, la emisión se rechaza.
- URL base. Todas las rutas de esta documentación son relativas a la URL base que te asignen (en los ejemplos,
). Por ejemplo, en el ambiente de calidad:https://calidad.cgimprenta.digital/. Prueba siempre primero en calidad. - Token. Pide un token con tu usuario y contraseña de API y envíalo en cada solicitud. Ver Autenticación.
Colección de Postman
Descarga la colección más reciente para probar todos los endpoints en el ambiente de calidad. Ejecuta primero Solicitar token: guarda el token en la variable y las demás solicitudes lo usan solas.
Descargar colección Postman v14Ambiente de calidad ·
{{host}} = https://calidad.cgimprenta.digital/Formato de las solicitudes
- Cuerpo en JSON (
Content-Type: application/json), codificado en UTF-8. - Las URLs tienen la forma
api/Invoice/<operación>. La parteInvoicetambién se acepta en minúscula (api/invoice/...). - Casi todas las operaciones de emisión trabajan por lotes: envías un arreglo de documentos y la respuesta indica cuáles se guardaron y cuáles no, con el motivo.
Formato de las respuestas
Todas las respuestas son JSON y traen al menos:
json
{
"success": true,
"message": "Texto descriptivo del resultado"
}success: false indica que la operación no se completó; message explica por qué. Revisa también el código HTTP: ver Errores. Los formatos de RIF, montos, fechas e impuestos están en Convenciones.
