> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Facturación electrónica

> Verifica cualquier documento tributario electrónico emitido en El Salvador contra el Ministerio de Hacienda: si existe, su estado, su sello de recepción y el documento tal como Hacienda lo registró.

Cada factura emitida en El Salvador es un documento tributario electrónico (DTE) transmitido al Ministerio de Hacienda, que le pone un sello de recepción. Facturas, comprobantes de crédito fiscal, notas de crédito y débito, comprobantes de retención, facturas de exportación y los demás traen un código de generación, impreso en el documento y en su código QR.

Con ese código, o el enlace del QR, obtienes lo que Hacienda tiene: si el documento existe, su estado (recibido, con observaciones, ajustado, rechazado o invalidado), el sello de recepción, el número de control, las fechas, los totales e impuestos y cada línea. Compáralo con el documento que tienes en la mano para distinguir una factura real de una alterada. La identidad del receptor nunca se devuelve.

`POST /sv/hacienda-sv/dte/v1` [Live](https://docs.usecroma.com/es/live-lookups.md)

Un código de entrada, lo que Hacienda registró de salida.

| Campo | Tipo | Notas |
| - | - | - |
| `generation_code` | string | **Obligatorio.** El código de generación del documento, p. ej. `3F2504E0-4F89-41D3-9A0C-0305E82C3301`, o el enlace de su código QR. No importan mayúsculas. |
| `environment` | enum | `production` (por defecto) para documentos reales, `test` para los emitidos en el ambiente de pruebas de Hacienda. Por defecto `production`. |

```bash theme={"dark"}
curl https://api.croma.run/sv/hacienda-sv/dte/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "generation_code": "3F2504E0-4F89-41D3-9A0C-0305E82C3301" }'
```

Devuelve `found`, `generation_code`, `environment`, `status`, `status_code` (el de Hacienda, p. ej. `SR`), `status_label`, `description`, `invalidated`, `checked_at` y `document`: `generation_code`, `control_number`, `type_code` (`01` factura, `03` comprobante de crédito fiscal, `05` nota de crédito, etc.), `type`, `version`, `issued_date`, `issued_time`, `processed_at`, `reception_seal`, `currency`, `subtotal`, `taxed_total`, `exempt_total`, `non_subject_total`, `discount_total`, `taxes[]` (`code`, `description`, `amount`), `income_tax_withheld`, `vat_withheld`, `vat_perceived`, `operation_total`, `total`, `total_in_words`, `payment_condition` e `items[]` (`number`, `code`, `description`, `quantity`, `unit_price`, `discount`, `taxed_sale`, `exempt_sale`, `non_subject_sale`).

> [!NOTE]
>
> Un código que Hacienda no tiene devuelve `found: false` con HTTP 200, no un error. El código basta para identificar un documento; no hace falta la fecha de emisión.

> **[Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)**
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.