E-mail de facturas
Listar plantillas de correo
Todas las plantillas del integrador, sin paginación; los ítems no traen el cuerpo.
/openapi/v2/emails/templatestoken, timestamp y sign, vea Autenticación.Lista las plantillas del integrador con filtros opcionales por tipo de documento, idioma y estado. Cada ítem trae los metadatos; corpoHtml y variaveisDisponiveis vienen como null y están en Consultar plantilla.
Parámetros de consulta
tipoDocumento | string | Filtro por tipo de documento |
idioma | string | Filtro por idioma |
ativo | bool | Filtro por estado |
* Campo obligatorio
total | int | Cantidad devuelta |
| array | Plantillas |
La lista devuelve todas las plantillas del integrador, sin paginación, en orden de creación. Los filtros son exactos y se combinan; sin filtros vienen todas. Para leer el cuerpo o la lista de variables use Consultar plantilla.
Encontrar la plantilla predeterminada de un tipo
Llame con tipoDocumento=NFe&ativo=true y tome el ítem con padrao = true; es el que usa el envío cuando se omite templateId. Si ningún ítem tiene padrao = true, un envío sin templateId devuelve 10021012.
{"total": 2,"itens": [{"templateId": "2103150000000000001","tipoDocumento": "NFe","idioma": "pt","nome": "NF-e padrão","assunto": "Nota fiscal {{numero}} - {{emitente.nome}}","corpoHtml": null,"padrao": true,"ativo": true,"variaveisDisponiveis": null,"criadoEm": "2026-09-28T12:00:00Z","atualizadoEm": "2026-09-28T12:00:00Z"},{"templateId": "2103150000000000002","tipoDocumento": "NFe","idioma": "en","nome": "NF-e english","assunto": "Invoice {{numero}} from {{emitente.nome}}","corpoHtml": null,"padrao": false,"ativo": true,"variaveisDisponiveis": null,"criadoEm": "2026-09-28T12:05:00Z","atualizadoEm": "2026-09-28T12:05:00Z"}]}
total* | int | Cantidad devuelta |
* | array | Plantillas |
* Campo obligatorio
Elegir la plantilla por idioma
Solo una plantilla por tipo es la predeterminada, sin importar el idioma. Para enviar en otro idioma filtre por idioma e informe el templateId del ítem elegido en el envío.
{"total": 1,"itens": [{"templateId": "2103150000000000002","tipoDocumento": "NFe","idioma": "en","nome": "NF-e english","assunto": "Invoice {{numero}} from {{emitente.nome}}","corpoHtml": null,"padrao": false,"ativo": true,"variaveisDisponiveis": null,"criadoEm": "2026-09-28T12:05:00Z","atualizadoEm": "2026-09-28T12:05:00Z"}]}
total* | int | Cantidad devuelta |
* | array | Plantillas |
* Campo obligatorio
tipoDocumentoTipo de documento
Vale para el filtro y para itens[].tipoDocumento.
| Valores | Significado |
|---|---|
| NFe | NF-e, factura de mercancías |
| NFSe | NFS-e, factura de servicios |
| CTe | CT-e, conocimiento de transporte |
| DCe | DC-e, declaración de contenido |
idiomaIdioma de la plantilla
Vale para el filtro y para itens[].idioma; el idioma define el formato de importes y fechas en las variables.
| Valores | Significado |
|---|---|
| pt | Portugués; importes 1.234,56, fechas dd/MM/yyyy HH:mm |
| en | Inglés; importes 1,234.56, fechas yyyy-MM-dd HH:mm |
| zh | Chino; importes 1,234.56, fechas yyyy-MM-dd HH:mm |
| es | Español; importes 1.234,56, fechas dd/MM/yyyy HH:mm |
| Código | HTTP | |
|---|---|---|
| 10021005 | 400 | Tipo de documento no soportado en tipoDocumento; solo NFe / NFSe / CTe / DCe. |