Ir al contenido
Docs

Referencia de la API

Facturación electrónica (DTE) para El Salvador

sudte API 1.0.0-draft

Sección titulada « sudte API 1.0.0-draft »

API de sudte para emitir, consultar e invalidar Documentos Tributarios Electrónicos ante el Ministerio de Hacienda de El Salvador.

  • Autenticación: Authorization: Bearer sk_test_… (ambiente de pruebas MH 00) o sk_live_… (producción 01).
  • Todos los POST requieren Idempotency-Key. Misma clave con otro cuerpo responde 409. Excepción: los endpoints de sesión del panel (/auth/*) no lo requieren.
  • Panel (app.sudte.com): cookie sudte_session + X-CSRF-Token (valor de Session.csrf_token) en métodos no seguros.
  • Montos como string decimal ("113.00"). Fechas ISO 8601, zona America/El_Salvador.
  • Errores en application/problem+json (RFC 9457), mensajes en español.

Este archivo es el contrato: se edita primero y de él salen docs, SDKs, panel y conector Odoo.

Información

  • OpenAPI version: 3.1.0

Operaciones

Sección titulada « Operaciones »
GET
/documents
POST
/documents
GET
/documents/{id}
GET
/documents/{id}/json
GET
/documents/{id}/pdf
POST
/documents/{id}/send
POST
/documents/{id}/retry
POST
/documents/{id}/void
GET
/emitters
POST
/emitters
GET
/emitters/{id}
PATCH
/emitters/{id}
PUT
/emitters/{id}/credentials
POST
/emitters/{id}/credentials/test
GET
/emitters/{id}/establishments
POST
/emitters/{id}/establishments
PATCH
/emitters/{id}/establishments/{establishment_id}
GET
/webhook-endpoints
POST
/webhook-endpoints
DELETE
/webhook-endpoints/{id}
POST
/webhook-endpoints/{id}/test
GET
/catalogs/{code}
POST
/emitters/{id}/fiscal/{resource}/batch
GET
/emitters/{id}/fiscal/{resource}
PUT
/emitters/{id}/fiscal/{resource}/{external_id}
DELETE
/emitters/{id}/fiscal/{resource}/{external_id}
PATCH
/documents/{id}/fiscal
GET
/fiscal/report-types
POST
/emitters/{id}/fiscal/reports
GET
/fiscal/reports/{id}
GET
/fiscal/reports/{id}/rows
GET
/fiscal/reports/{id}/files/{format}
GET
/emitters/{id}/fiscal/periods
POST
/emitters/{id}/fiscal/periods/{period}/close
POST
/emitters/{id}/fiscal/periods/{period}/reopen
POST
/fiscal/embed-sessions
GET
/plans
GET
/account/usage

Autenticación

Sección titulada « Autenticación »

apiKey

Sección titulada « apiKey »

Sk_test_… o sk_live_…

Security scheme type: http

session

Sección titulada « session »

Sesión del panel app.sudte.com

Security scheme type: apiKey

Cookie parameter name: sudte_session