API Facturación

Guía de Inicio Rápido

Esta guía te ayudará a implementar la API de Facturación Electrónica en tan solo 4 pasos simples.

Requisitos previos

  • NIT y NRC de tu empresa
  • Certificado digital para firma electrónica
  • Credenciales de acceso al portal del Ministerio de Hacienda

Paso 1: Registra tu cuenta

El primer paso es registrar tu empresa en el sistema utilizando el endpoint /api/v1/auth/register.

POST /api/v1/auth/register

Registra tu empresa y sucursales en el sistema

💡 Consejo: Guarda de forma segura las credenciales api_key y api_secret que recibirás en la respuesta. Las necesitarás para todos los pasos siguientes.

Ejemplo de Solicitud

Request 

{
  "nit": "12345678911227",
  "nrc": "1233260",
  "auth_type": "STANDARD",
  "business_name": "EMPRESA DE PRUEBAS SA DE CV",
  "commercial_name": "EMPRESA DE PRUEBAS",
  "economic_activity": "47190",
  "economic_activity_desc": "Venta al por mayor de otros productos",
  "phone": "21212828",
  "email": "facturacion@empresa.com.sv",
  "password_pri": "Tu-password-de-certificado#",
  "year_in_dte": true,
  "token_lifetime": 30,
  "branch_offices": [
    {
      "establishment_type": "02",
      "establishment_code": "CENTRAL",
      "address": {
        "department": "06",
        "municipality": "20",
        "complement": "BOULEVARD SANTA ELENA SUR, SANTA TECLA"
      }
    }
  ]
}

Paso 2: Obtén un token JWT

Con tus credenciales, obtén un token JWT que te permitirá autenticar todas tus solicitudes:

POST /api/v1/auth/login

Obtén un token JWT para autenticar tus peticiones

Ejemplo de Solicitud

Request 

{
  "api_key": "b5fdbe3ed9d919ae0298...",
  "api_secret": "4sIQwMA5CDc7wRIXU...",
  "credentials": {
    "username": "TU-HACIENDA-USERNAME",
    "password": "TU-HACIENDA-PASSWORD-API"
  }
}

Paso 3: Emite tu primera factura

Ahora puedes emitir tu primera factura electrónica:

POST /api/v1/invoices

Emite una nueva factura electrónica

Ejemplo de Solicitud

Request 

{
 "items": [
    {
      "type": 1,
      "description": "Producto de ejemplo",
      "quantity": 2,
      "unit_measure": 59,
      "unit_price": 50.00,
      "taxed_sale": 100.00,
      "iva_item": 11.50
    }
  ],
  "summary": {
    "total_taxed": 100.00,
    "sub_total": 100.00,
    "sub_total_sales": 100.00,
    "total_operation": 100.00,
    "total_to_pay": 100.00,
    "operation_condition": 1,
    "total_iva": 11.50,
    "payment_types": [
      {
        "code": "01",
        "amount": 100.00
      }
    ]
  }
}

Paso 4: Verifica el estado del documento

Confirma que tu documento fue recibido correctamente:

GET /api/v1/dte/F64D69AD-05AB-4555-AE2A-76C610513DA0

Consulta el estado de un documento emitido usando su UUID

¿Qué sigue?

Emite otros tipos de documentos

Aprende a emitir CCF, notas de crédito y otros documentos fiscales