Através deste serviço é possível realizar o envio de um MDF-e autorizado e seus eventos por e-mail, pela NS MDF-e API.
O endereço de remetente utilizado será o e-mail configurado para o contribuinte no Painel.
URL
Produção: POST https://mdfe.ns.eti.br/util/enviaremail
Dados de entrada
| Campo | Descrição | Tipo | Pai | Ocorrência | Observação |
|---|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso da SH | String | 1-1 | ||
| chMDFe | Chave de acesso do MDF-e que será enviada | String | 1-1 | ||
| tpAmb | Tipo de Ambiente onde o MDF-e se encontra | Integer | 1-1 | 1 - Produção; 2 - Homologação |
|
| anexarPDF | Indica se o PDF do documento deve ser gerado e anexado junto | Boolean | 0-1 | A opção configurada para o contribuinte no painel será levada em consideração | |
| anexarEvento | Indica se os eventos devem ser anexados junto | Boolean | 0-1 | ||
| emails | Lista de endereços de destino | Array(String) | 1-N | ||
| endereco | E-mail de destino | emails | 1-1 |
Exemplo de requisição
Exemplo de requisição
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN": "SEU_TOKEN",
"chMDFe": "99999999999999999999999999999999999999999999",
"tpAmb": 2,
"emails": [
{
"endereco": "exemplo@gmail.com"
}
]
}'\
https://mdfe.ns.eti.br/util/enviaremail
Dados retornados
| Campo | Descrição | Tipo | Ocorrência | Observação |
|---|---|---|---|---|
| status | Código de status do processamento | Integer | 1-1 | |
| motivo | Descrição literal do status de processamento | String | 1-1 | |
| erro | Objeto contendo as informações do erro | Object | 0-1 | Apenas em status -3 |
| cStat | Código de status do erro | Integer | 1-1 | |
| xMotivo | Descrição literal do erro | String | 1-1 |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Envio de e-mail agendado com sucesso"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Reenvio de e-mail agendado com sucesso |
| -2 | Campo tpAmb com valor invalido. Deve ser do tipo numérico e preenchido com 1 ou 2 |
| -3 | Nao foi possivel agendar o envio de e-mail. Verifique o nodo erro |
| -4 | O campo emails deve ser informado como uma lista de strings |
| -5 | Chave de acesso inválida |
| -6 | Cada elemento da lista de e-mails deve ser informado com nome 'endereco' |
| -7 | Documento não localizado |