Saltar a contenido
tml lang="es" class="no-js"> API Facturación Electrónica (FE) - Docucenter

🧾 API Facturación Electrónica (FE) - DocuCenter

📋 Introducción

Las APIs de Facturación Electrónica (FE) permiten la integración con el sistema de facturación electrónica de Panamá, facilitando la emisión de facturas electrónicas desde diferentes plataformas y sistemas ERP.

Autenticación: Bearer Token requerido para todos los endpoints

Middleware: check.activate.organization - Verificación de organización activa

💼 Emitir Factura desde ACICloud

POST /api/v1/fe/create_sale_acicloud

Crea y emite una factura electrónica basada en datos provenientes del sistema Sage ACICloud.

Controller: FeController::createSaleAciCloud

Autenticación: Bearer Token requerido

📤 Headers Requeridos

Authorization: Bearer {token}
Content-Type: application/json

📝 Campos de Request

Campo Tipo Requerido Descripción
dGen.gDatRec.iTipoRec string ✅ Tipo de receptor
dGen.gDatRec.gRucRec.dTipoRuc string ✅ Tipo de RUC (default: "1")
gTot.gFormaPago[].iFormaPago string ✅ Forma de pago
gItem[].gITBMSItem.dTasaITBMS string ✅ Tasa de ITBMS

📨 Ejemplo de Request

{
  "dGen": {
    "gDatRec": {
      "iTipoRec": "01",
      "gRucRec": {
        "dTipoRuc": "1"
      }
    }
  },
  "gTot": {
    "gFormaPago": [
      {
        "iFormaPago": "01",
        "dMontoFPago": "118.00"
      }
    ]
  },
  "gItem": [
    {
      "dCodProd": "PROD001",
      "dDesProd": "Producto ejemplo",
      "dCantProd": "1.00",
      "dPrUnit": "100.00",
      "gITBMSItem": {
        "dTasaITBMS": "07"
      }
    }
  ]
}

📊 Emitir Factura desde Quickbooks

POST /api/v1/fe/create_sale_quickbooks

Crea y emite una factura electrónica basada en datos provenientes de Quickbooks Online.

Controller: FeController::createSaleQuickbooks

Autenticación: Bearer Token requerido

🛒 Emitir Factura desde Shopify

POST /api/v1/fe/create_sale_shopify

Crea y emite una factura electrónica basada en datos provenientes de Shopify.

Controller: FeController::createSaleShopify

Autenticación: Bearer Token requerido

⚡ Emitir Factura desde Lightspeed

POST /api/v1/fe/create_sale_lightspeed

Crea y emite una factura electrónica basada en datos provenientes de Lightspeed.

Controller: FeController::createSaleLightspeed

Autenticación: Bearer Token requerido

📄 Importar XML

POST /api/v1/fe/import_xml

Importa y procesa archivos XML para generar facturas electrónicas.

Controller: FeController::importXml

Autenticación: Bearer Token requerido

📋 Emitir Objeto JSON

POST /api/v1/fe/emit_json_object

Emite una factura electrónica a partir de un objeto JSON estructurado.

Controller: FeController::emitObject

Autenticación: Bearer Token requerido

📥 Descargar Documento Base64

GET /api/v1/fe/download_base64_document/{id}

Descarga un documento de factura electrónica en formato Base64.

Controller: FeController::downloadBase64Document

Autenticación: Bearer Token requerido

📝 Parámetros de URL

Parámetro Tipo Requerido Descripción
id integer ✅ ID del documento FE

📊 Códigos de Respuesta HTTP

Código Descripción
200 Factura procesada exitosamente
201 Factura creada y emitida exitosamente
400 Datos de entrada inválidos
401 No autorizado
422 Error de validación
500 Error interno del servidor

⚙️ Notas Técnicas

  • Formato de fechas: ISO 8601 (YYYY-MM-DDTHH:MM:SS)
  • Monedas: Soporte para USD y PAB
  • ITBMS: Cálculo automático de impuestos
  • Validaciones: Validación estricta según normativas DGI
  • Asincronía: Procesamiento en background con Jobs
  • Multi-tenant: Respeta el contexto de organización

📞 Soporte

Para soporte con facturación electrónica: