Através deste serviço é possível realizar o envio de uma NFCom autorizada pela API por e-mail e/ou reenviar a NFCom para os e-mails contidos no XML.
O endereço de remetente utilizado será o e-mail configurado para o contribuinte no Painel.
URL
Produção: POST https://nfcom.ns.eti.br/util/enviaremail
Dados de entrada
Os dados de entrada deste método por ser enviado no corpo da requisição em formato JSON ou como QueryString na URL do método.
| Campo | Descrição | Tipo | Ocorrência | Observação |
|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | String | 0-1 | |
| chNFCom | Chave de acesso da NFCom que será enviada | String | 1-1 | |
| tpAmb | Tipo de Ambiente onde a NFCom foi autorizada | Integer | 1-1 | 1 - Produção 2 - Homologação |
| enviaEmailDoc | Enviar para e-mails originais contidos no XML do documento | Boolean | 0-1 | Obrigatório se o campo email não for enviado.Valor padrão: False |
| anexarPDF | Indica se o PDF do documento deve ser gerado e anexado junto | Boolean | 0-1 | |
| anexarEvento | Indica se os eventos devem ser anexados junto | Boolean | 0-1 | |
| E-mail de destino | Array(String) | 0-N | Obrigatório se o campo enviaEmailDoc não for enviado. |
Exemplo de requisição
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"chNFCom": "43260807364617000135620000000002431000000016",
"tpAmb": "2",
"emails": [
"lucaorpacheco@gmail.com"
],
"anexarPDF": true,
"anexarEvento": false
}'\
https://nfcom.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 | Integer | 1-1 | |
| erro | Objeto contendo as informações do erro | Object | 0-1 | Apenas em status diferente de 200 e -2 |
| 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": "Reenvio de e-mail agendado com sucesso"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Reenvio de e-mail agendado com sucesso |
| -2 | 'enviaEmailDoc' deve ser true ou os enderecos de destino devem ser informados no campo 'email' |
| -3 | Não foi possível realizar o agendamento do envio de e-mail.Verifique o objeto erro para identificar o motivo. |