Factura Electrónica SV

Integración API para Facturación Electrónica

Documenta e integra fácilmente con nuestra API para emitir y gestionar facturas electrónicas en El Salvador. Cumple con las regulaciones del Ministerio de Hacienda de manera sencilla.

Integración con nuestra API REST

Emite un Documento Tributario Electrónico con la API pública. Autentícate con tu API key (Bearer), crea el DTE con la envoltura pointOfSaleId / establishmentId / dte y consulta el resultado: la firma y transmisión al Ministerio de Hacienda ocurren de forma asíncrona.

crear_factura.sh

1 # 1) Crear una Factura Consumidor Final (FC)
2 #    El emisor se resuelve desde la API key. Puedes usar customerId para
3 #    autocompletar el receptor y productId para autocompletar cada ítem.
4 curl -X POST https://api.facturaelectronicasv.com/api/v1/public/dtes/fc \
5   -H "Authorization: Bearer YOUR_API_KEY" \
6   -H "Content-Type: application/json" \
7   -d '{
8     "pointOfSaleId": "0a9d2b1c-3e4f-4a5b-8c6d-7e8f9a0b1c2d",
9     "establishmentId": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
10     "sendEmail": true,
11     "dte": {
12       "environment": "01",
13       "recipient": { "customerId": "f47ac10b-58cc-4372-a567-0e02b2c3d479" },
14       "items": [
15         {
16           "productId": 1024,
17           "itemType": 1,
18           "quantity": 2,
19           "documentNumber": null,
20           "internalCode": null,
21           "taxCode": null,
22           "discountAmount": 0,
23           "nonTaxableSales": 0,
24           "exemptSales": 0,
25           "taxableSales": 1799.98,
26           "taxes": ["20"],
27           "suggestedSalePrice": 0,
28           "taxFree": 0,
29           "itemVat": 207.06
30         }
31       ],
32       "summary": {
33         "totalNonTaxableSales": 0,
34         "totalExemptSales": 0,
35         "totalTaxableSales": 1799.98,
36         "subTotalSales": 1799.98,
37         "discountNonTaxableSales": 0,
38         "discountExemptSales": 0,
39         "discountTaxableSales": 0,
40         "discountPercentage": 0,
41         "totalDiscount": 0,
42         "taxes": [{ "code": "20", "description": "IVA 13%", "value": 207.06 }],
43         "subTotal": 1799.98,
44         "totalVat": 207.06,
45         "vatWithholding1": 0,
46         "incomeTaxWithholding": 0,
47         "totalOperationAmount": 1799.98,
48         "nonTaxableTotal": 0,
49         "totalToPay": 1799.98,
50         "totalInLetters": "MIL SETECIENTOS NOVENTA Y NUEVE 98/100",
51         "balanceInFavor": 0,
52         "operationCondition": 1,
53         "payments": null,
54         "electronicPaymentNumber": null,
55         "observations": null
56       }
57     }
58   }'
59 # Respuesta 201:
60 # { "success": true, "data": { "id": "DTE_ID", "status": "PENDING", "controlNumber": null } }
61  
62 # 2) Consultar el DTE (firma/transmisión asíncronas). Cuando status sea
63 #    TRANSMITTED, data.controlNumber queda asignado por el MH.
64 curl https://api.facturaelectronicasv.com/api/v1/public/dtes/DTE_ID \
65   -H "Authorization: Bearer YOUR_API_KEY"
66  
67 # 3) Descargar el PDF (status TRANSMITTED, PDF_GENERATED o NOTIFIED)
68 curl https://api.facturaelectronicasv.com/api/v1/public/dtes/DTE_ID/pdf \
69   -H "Authorization: Bearer YOUR_API_KEY" \
70   --output factura.pdf

Características principales

Nuestra API está diseñada para facilitar la integración de la facturación electrónica en su sistema existente.

Emisión de Documentos

Genera todo tipo de documentos tributarios electrónicos (DTE) validados por el Ministerio de Hacienda.

Integración Flexible

Compatible con múltiples lenguajes de programación y frameworks. API REST con documentación completa.

Almacenamiento Seguro

Almacenamiento de documentos en la nube por el tiempo reglamentario con respaldos automáticos.

Explora nuestras soluciones

Conoce las diferentes opciones disponibles para tu empresa.

API REST para desarrolladores

Integra directamente con tu sistema existente

Documentación completa con ejemplos en múltiples lenguajes
Entorno de sandbox para pruebas

¿Listo para empezar?

Regístrate hoy y comienza a emitir facturas electrónicas que cumplan con todas las regulaciones de El Salvador.

Factura Electrónica SV

Integración API para Facturación Electrónica

Documenta e integra fácilmente con nuestra API para emitir y gestionar facturas electrónicas en El Salvador. Cumple con las regulaciones del Ministerio de Hacienda de manera sencilla.

Integración con nuestra API REST

crear_factura.sh

1 # 1) Crear una Factura Consumidor Final (FC)
2 #    El emisor se resuelve desde la API key. Puedes usar customerId para
3 #    autocompletar el receptor y productId para autocompletar cada ítem.
4 curl -X POST https://api.facturaelectronicasv.com/api/v1/public/dtes/fc \
5   -H "Authorization: Bearer YOUR_API_KEY" \
6   -H "Content-Type: application/json" \
7   -d '{
8     "pointOfSaleId": "0a9d2b1c-3e4f-4a5b-8c6d-7e8f9a0b1c2d",
9     "establishmentId": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
10     "sendEmail": true,
11     "dte": {
12       "environment": "01",
13       "recipient": { "customerId": "f47ac10b-58cc-4372-a567-0e02b2c3d479" },
14       "items": [
15         {
16           "productId": 1024,
17           "itemType": 1,
18           "quantity": 2,
19           "documentNumber": null,
20           "internalCode": null,
21           "taxCode": null,
22           "discountAmount": 0,
23           "nonTaxableSales": 0,
24           "exemptSales": 0,
25           "taxableSales": 1799.98,
26           "taxes": ["20"],
27           "suggestedSalePrice": 0,
28           "taxFree": 0,
29           "itemVat": 207.06
30         }
31       ],
32       "summary": {
33         "totalNonTaxableSales": 0,
34         "totalExemptSales": 0,
35         "totalTaxableSales": 1799.98,
36         "subTotalSales": 1799.98,
37         "discountNonTaxableSales": 0,
38         "discountExemptSales": 0,
39         "discountTaxableSales": 0,
40         "discountPercentage": 0,
41         "totalDiscount": 0,
42         "taxes": [{ "code": "20", "description": "IVA 13%", "value": 207.06 }],
43         "subTotal": 1799.98,
44         "totalVat": 207.06,
45         "vatWithholding1": 0,
46         "incomeTaxWithholding": 0,
47         "totalOperationAmount": 1799.98,
48         "nonTaxableTotal": 0,
49         "totalToPay": 1799.98,
50         "totalInLetters": "MIL SETECIENTOS NOVENTA Y NUEVE 98/100",
51         "balanceInFavor": 0,
52         "operationCondition": 1,
53         "payments": null,
54         "electronicPaymentNumber": null,
55         "observations": null
56       }
57     }
58   }'
59 # Respuesta 201:
60 # { "success": true, "data": { "id": "DTE_ID", "status": "PENDING", "controlNumber": null } }
61  
62 # 2) Consultar el DTE (firma/transmisión asíncronas). Cuando status sea
63 #    TRANSMITTED, data.controlNumber queda asignado por el MH.
64 curl https://api.facturaelectronicasv.com/api/v1/public/dtes/DTE_ID \
65   -H "Authorization: Bearer YOUR_API_KEY"
66  
67 # 3) Descargar el PDF (status TRANSMITTED, PDF_GENERATED o NOTIFIED)
68 curl https://api.facturaelectronicasv.com/api/v1/public/dtes/DTE_ID/pdf \
69   -H "Authorization: Bearer YOUR_API_KEY" \
70   --output factura.pdf

1	# 1) Crear una Factura Consumidor Final (FC)
2	# El emisor se resuelve desde la API key. Puedes usar customerId para
3	# autocompletar el receptor y productId para autocompletar cada ítem.
4	curl -X POST https://api.facturaelectronicasv.com/api/v1/public/dtes/fc \
5	-H "Authorization: Bearer YOUR_API_KEY" \
6	-H "Content-Type: application/json" \
7	-d '{
8	"pointOfSaleId": "0a9d2b1c-3e4f-4a5b-8c6d-7e8f9a0b1c2d",
9	"establishmentId": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
10	"sendEmail": true,
11	"dte": {
12	"environment": "01",
13	"recipient": { "customerId": "f47ac10b-58cc-4372-a567-0e02b2c3d479" },
14	"items": [
15	{
16	"productId": 1024,
17	"itemType": 1,
18	"quantity": 2,
19	"documentNumber": null,
20	"internalCode": null,
21	"taxCode": null,
22	"discountAmount": 0,
23	"nonTaxableSales": 0,
24	"exemptSales": 0,
25	"taxableSales": 1799.98,
26	"taxes": ["20"],
27	"suggestedSalePrice": 0,
28	"taxFree": 0,
29	"itemVat": 207.06
30	}
31	],
32	"summary": {
33	"totalNonTaxableSales": 0,
34	"totalExemptSales": 0,
35	"totalTaxableSales": 1799.98,
36	"subTotalSales": 1799.98,
37	"discountNonTaxableSales": 0,
38	"discountExemptSales": 0,
39	"discountTaxableSales": 0,
40	"discountPercentage": 0,
41	"totalDiscount": 0,
42	"taxes": [{ "code": "20", "description": "IVA 13%", "value": 207.06 }],
43	"subTotal": 1799.98,
44	"totalVat": 207.06,
45	"vatWithholding1": 0,
46	"incomeTaxWithholding": 0,
47	"totalOperationAmount": 1799.98,
48	"nonTaxableTotal": 0,
49	"totalToPay": 1799.98,
50	"totalInLetters": "MIL SETECIENTOS NOVENTA Y NUEVE 98/100",
51	"balanceInFavor": 0,
52	"operationCondition": 1,
53	"payments": null,
54	"electronicPaymentNumber": null,
55	"observations": null
56	}
57	}
58	}'
59	# Respuesta 201:
60	# { "success": true, "data": { "id": "DTE_ID", "status": "PENDING", "controlNumber": null } }
61
62	# 2) Consultar el DTE (firma/transmisión asíncronas). Cuando status sea
63	# TRANSMITTED, data.controlNumber queda asignado por el MH.
64	curl https://api.facturaelectronicasv.com/api/v1/public/dtes/DTE_ID \
65	-H "Authorization: Bearer YOUR_API_KEY"
66
67	# 3) Descargar el PDF (status TRANSMITTED, PDF_GENERATED o NOTIFIED)
68	curl https://api.facturaelectronicasv.com/api/v1/public/dtes/DTE_ID/pdf \
69	-H "Authorization: Bearer YOUR_API_KEY" \
70	--output factura.pdf