Envio de email
Envia um documento por email. Existem três formas de filtrar os documentos que serão enviados:
1. Por chaves de acesso. Informe as chaves de acesso, separadas por ponto, vírgula, ponto e vírgula, quebra de linha ou um caractere de espaço | . | , | ; | \n |
2. Pelo número do documento. Informe obrigatóriamente um número final, um número inicial, ano da emissão do documento, dígitos do mês de emissão do documento, o número de série, o código do modelo do documento, o(s) cnpj(s) relacionado(s) (sem máscara) e o tipo de relação do(s) cnpj(s) com os documentos.
3. Pela data de emissão. Informe obrigatóriamente uma data final de emissão, uma data inicial de emissão, o número de série, o código do modelo dos documentso, o(s) cnpj(s) relacionado(s) (sem máscara) e o tipo de relação do(s) cnpj(s) com os documentos.
Em todos os casos o tipo de ambiente é obrigatório. No caso de faltar agum campo ou algum campo for inválido o filtro não será aplicado.
Os tipos de relação permitidos entre um cnpj e um documento são: emitente, destinatario, autorizado, tomador, expedidor, transportador, remetente e recebedor.
O campo 'reenvia' é resposável por indicar se o documento deve ser enviado para os emails contidos no xml do dcumento. Se este campo estiver nulo ou marcado como 'false', o campo de 'destinatarios' se torna obrigatório.
O campo 'anexos' pode receber até quatro valores válidos, que representam os anexos contidos nos emails enviados: procDFe, dadfe, procEvento e dacce. Os valores são, respectivamente, o XML do documento, o PDF do documento auxiliar, o XML do evento e o PDF do documento auxiliar da carta de correção (válido para NFe e CTe). O valor padrão desse campo, caso seja nulo, é procDFe, dadfe e procEvento. Qualquer outro valor será ignorado.
O campo 'assunto' pode receber variáveis para representar dinâmicamente o valor de algum atributo do documento. Essas variáveis são representadas pelo nome do atributo em maiúsculo e cercado pelo caracter '|'. Por exemplo, se adicionado no assunto o texto |SERIE|, o mesmo será substituído pelo número de série do documento. Os atributos permitidos variam de acordo com o modelo do documento e são: |NUMERO|, |STATUS|, |EMITENTE|, |CNPJ_EMITENTE|, |CHAVE_ACESSO|, |DESTINATARIO| (exceção de CTeOs, NFSe e MDFe), |CNPJ_DESTINATARIOS| (exceção de CTeOs, NFSe e MDFe), |SERIE| (exceção de CFe), |TOMADOR| (apenas CTe, CTeOS e NFSE), |CNPJ_TOMADOR| (apenas CTe, CTeOS e NFSe), |PRESTADOR| (apenas NFSe), |CNPJ_PRESTADOR| (apenas NFSe), |TRANSPORTADOR| (apenas NFe), |CNPJ_TRANSPORTADOR| (apenas NFe).
Os campos de assunto e mensagem são opcionais e caso não venham preenchidos o conteúdopadrão será adicionado de acordo com o modelo do monitor
O máximo de emails que podem ser enviados seguem o valor definido no parametro PAINEL_QTDE_MAXIMA_EMAILS_DFE
O retorno do endpoint contém um array com as chaves de acesso de documentos enviados e um map contendo a chaves de acesso de documentos não enviados juntamente com a sua justificativa. Documentos não encontrados não serão referenciados no retorno. Caso nenhum documento sea encontrado, o status do retorno será 404
Header Parameters
- x-auth-token string required
identificador de sessão
- application/json
Request Body required
emailDto
- ambiente string
- anexos string[]
- ano int32
- assunto string
- chavesAcesso string
- cnpjs string[]
- codigoModelo int32
- dataFinal date-time
- dataInicial date-time
- destinatarios string[]
- mensagem string
- mes int32
- numeroFinal int64
- numeroInicial int64
- reenvia boolean
- serie int64
- tipoRelacao string
- 200
- 201
- 401
- 403
- 404
OK
- */*
- Schema
- Example (from schema)
Schema
body object
- statusCode string
Possible values: [
100,101,102,103,200,201,202,203,204,205,206,207,208,226,300,301,302,303,304,305,307,308,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,418,419,420,421,422,423,424,426,428,429,431,451,500,501,502,503,504,505,506,507,508,509,510,511] - statusCodeValue int32
{
"body": {},
"statusCode": "100",
"statusCodeValue": 0
}
Created
Unauthorized
Forbidden
Not Found






