Skip to content

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 ​

ÁreaOperaciones
AutenticaciónSolicitar token
Documentos fiscalesFactura, factura a terceros, nota de crédito (total o parcial), nota de débito, orden de entrega (individual), guía de despacho (opcional)
RetencionesIVA, ISLR, consulta de IVA e ISLR, códigos ISLR, anulación
Productos y clientesRegistrar productos, registrar clientes, consultar clientes
ConsultasMétodos de pago, bancos, facturas emitidas
OperacionesEnviar documento por correo, anular factura

Antes de empezar ​

  1. 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.
  2. 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.
  3. 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 parte Invoice tambié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.

API de Facturación · CG Imprenta Digital