> ## 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.

# Faturamento eletrônico

> Verifique qualquer documento fiscal eletrônico emitido em El Salvador junto ao Ministerio de Hacienda: se existe, seu status, seu selo de recepção e o documento como a Hacienda o registrou.

Cada fatura emitida em El Salvador é um documento tributário eletrônico (DTE) transmitido ao Ministerio de Hacienda, que lhe dá um selo de recepção. Faturas, comprobantes de crédito fiscal, notas de crédito e débito, comprobantes de retenção, faturas de exportação e os demais trazem um código de geração, impresso no documento e no seu código QR.

Com esse código, ou o link do QR, você obtém o que a Hacienda tem: se o documento existe, seu status (recebido, com observações, ajustado, rejeitado ou invalidado), o selo de recepção, o número de controle, as datas, os totais e impostos e cada linha. Compare com o documento em mãos para distinguir uma fatura real de uma alterada. A identidade do receptor nunca é retornada.

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

Um código de entrada, o que a Hacienda registrou de saída.

| Campo | Tipo | Notas |
| - | - | - |
| `generation_code` | string | **Obrigatório.** O código de geração do documento, p. ex. `3F2504E0-4F89-41D3-9A0C-0305E82C3301`, ou o link do seu código QR. Maiúsculas não importam. |
| `environment` | enum | `production` (padrão) para documentos reais, `test` para os emitidos no ambiente de testes da Hacienda. Por padrão `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" }'
```

Retorna `found`, `generation_code`, `environment`, `status`, `status_code` (o da Hacienda, p. ex. `SR`), `status_label`, `description`, `invalidated`, `checked_at` e `document`: `generation_code`, `control_number`, `type_code` (`01` fatura, `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]
>
> Um código que a Hacienda não tem retorna `found: false` com HTTP 200, não um erro. O código basta para identificar um documento; a data de emissão não é necessária.

> **[Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)**
>
> Esquemas, todos os campos de resposta e um playground interativo.


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