Información de Sucursal

Este endpoint permite verificar el estado de conexión del token de API y obtener la información fiscal completa del emisor (empresa) junto con los permisos de documentos electrónicos asignados.

Endpoint

GET /dte/information

(Consulta la guía de Endpoints y Entornos para obtener la URL base).

Headers Requeridos

Debe incluirse uno de los siguientes headers para autenticar la petición:

Header	Requerido	Descripción
`x-api-token`	Sí*	Token de la sucursal (ej: `b079562f85...`)
`Authorization`	Sí*	Formato Bearer: `Bearer tu_token_aqui`

*Solo se requiere uno de los dos métodos de autenticación.

Estructura de Respuesta (JSON)

Cuando la petición es correcta, la API devuelve un código 200 OK con la información de la empresa y la lista de documentos que el token tiene autorizado emitir.

{
  "status": "success",
  "data": {
    "emisor": {
      "id": 99,
      "nit": "0614-123456-101-3",
      "nrc": "123456-7",
      "nombre": "DISTRIBUIDORA DE PRUEBAS EL SALVADOR S.A. DE C.V.",
      "nombreComercial": "Comercial El Amigo",
      "codigoActividad": "47110",
      "actividadEconomica": "Venta al por menor en comercios no especializados...",
      "direccion": "CALLE EL MIRADOR, EDIFICIO TORRE FUTURA, NIVEL 10, COLONIA ESCALON",
      "tipoEstablecimiento": "01",
      "departamento": "06",
      "municipio": "14",
      "distrito": "01",
      "telefono": "2255-0000",
      "correo": "[email protected]",
      "logoUrl": "emisores/distribuidora_de_pruebas_sv/logo/06141234561013.png",
      "colorPrincipal": "#1A5276",
      "colorSecundario": "#5DADE2",
      "colorFondo": "#F2F4F4",
      "codEstableMH": "0000",
      "codEstable": "0000",
      "codPuntoVentaMH": "0001",
      "codPuntoVenta": "0001",
      "ambiente": "TEST",
      "clientId": 1,
      "createdAt": "2026-06-08T03:52:00.000Z"
    },
    "permissions": [
      "FACTURA_CONSUMIDOR_FINAL",
      "ANULACION",
      "CREDITO_FISCAL",
      "SUJETO_EXCLUIDO",
      "NOTA_CREDITO",
      "NOTA_DEBITO",
      "COMPROBANTE_RETENCION"
    ]
  }
}

Campos de Respuesta

Objeto `emisor`

nit / nrc: Identificadores tributarios de la empresa registrados ante el Ministerio de Hacienda de El Salvador.
nombre / nombreComercial: Nombre fiscal (Razón Social) y nombre comercial de la empresa.
codigoActividad / actividadEconomica: Actividad comercial homologada por el Ministerio de Hacienda.
direccion: Dirección física registrada.
departamento / municipio / distrito: Códigos de ubicación geográfica según el catálogo de Hacienda.
ambiente: TEST para ambiente de pruebas y PROD para ambiente productivo.

Array `permissions`

Lista de documentos electrónicos (DTE) y operaciones especiales que este token tiene autorización para procesar:

FACTURA_CONSUMIDOR_FINAL (DTE-01)
CREDITO_FISCAL (DTE-03)
NOTA_CREDITO (DTE-05)
NOTA_DEBITO (DTE-06)
SUJETO_EXCLUIDO (DTE-14)
COMPROBANTE_RETENCION (DTE-07)
ANULACION (Invalidaciones de DTE)