- Page Content
- Introduction
- Input format
- Output format
Name:EvListarEmailValido
This function is intended to list Valid Email by subject and/or date of receipt and/or date of delivery and/or Status.
Input format:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<EmailValido>
<IDCliente>999</IDCliente>
<CNPJCliente>99999999999999</CNPJCliente>
<Assunto>{*EVS:minhachave*}XXXX</Assunto>
<datarecebimento>XX</datarecebimento>
<dataentrega>XX</dataentrega>
<status>XX</status>
<DetalheAnexo>XX</DetalheAnexo>
<ParGestao>XX</ParGestao>
</EmailValido>
| Parameter | Format | Required | Description |
|---|---|---|---|
| EmailValido | Y | Node to define emails to be queried | |
| IDCliente | Numeric | Y | Client code |
| CNPJCliente | Numeric | Y | CNPJ of the client without dashes, bars or dots |
| Assunto | Text | N | Subject or part of the subject of the email to be searched. If the first 6 bytes of the SUB tag is the constant "{* EVS: XXXXXXX *} the EVS search will be performed, a constant entered in the body of the email that is removed when sending to the recipient. The purpose is to use a client ID for subsequent location of EVs in the QualiSign Portal. |
| datarecebimento | Numeric | N | Initial search date in DD/MM/YYYY format, considering the data received from the email by QualiSign. |
| dataentrega | Numeric | N | Initial search date in DD/MM/YYYY format, considering the date of sending the email to the recipient by QualiSign |
| status | Text | N | Status code as per table below:
|
| DetalheAnexo | String | N | Indicates that you want to receive attachment reading information. Possible values: S - Yes, N - No. If the option is N, the Attachments Node is not returned |
| ParGestao | Numeric | N | Filter by management code: 0 - filters emails that have management charged N - filter emails that will have management charged in n months |
Output format:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<EmailValido>
<CodErro></CodErro>
<MsgErro></MsgErro>
<EV>
<EmailRemetente></EmailRemetente>
<EmailDestinatario></EmailDestinatario>
<Assunto></Assunto>
<DataEnviado></DataEnviado>
<Entregue></Entregue>
<DataEntregue></ DataEntregue>
<TentativasRestantes></TentativasRestantes>
<Lido></Lido>
<LidoData1Leitura></LidoData1Leitura>
<Status></Status>
<MensagemErro></MensagemErro>
<EVS></EVS>
<SeloClicado></SeloClicado>
<SeloClicadoData1Leitura></SeloClicadoData1Leitura>
<EVID></EVID>
<EV_TamMsg></EV_TamMsg>
<Anexos>
<Anexo>
<NomeAnexo></NomeAnexo>
<AnexoLido></AnexoLido>
<AnexoLidoData1Leitura></AnexoLidoData1Leitura>
</Anexo>
</Anexos>
</EV>
</EmailValido>
| Parameter | Format | Description |
|---|---|---|
| EmailValido | Node to define emails to be queried | |
| CodErro | Numeric | Error Code (See Valid Email Error Codes) |
| MsgErro | Text | Error message |
| EV | Node to define emails to be queried.For each email returned in the query a new EV node will be created. If no email returns in the query, this node will not exist. | |
| EmailRemetente | Text | Sender's email address |
| EmailDestinatario | Text | Recipient's email address |
| Assunto | Text | Full email Subject |
| DataEnviado | Text | Send date in DD/MM/YYYY HH:MM:SS + (HLB) format |
| Entregue | Text | S for delivered or N for not delivered |
| DataEntregue | Text | Date of delivery of the email in DD/MM/YYYY HH:MM:SS + (HLB) format |
| TentativasRestantes | Text | The amount of attempts remaining in the descending delivery. If already delivered show 0 (ZERO) |
| Lido | Text | S for email read by recipient and N for unread |
| LidoData1Leitura | Text | Date of first reading in DD/MM/YYYY HH:MM:SS + (HLB) format |
| Status | Text | Valid Email status |
| MensagemErro | Text | Error Message |
| EVS | Text | EVS |
| SeloClicado | Text | S for stamp clicked by recipient and N for not clicked |
| SeloClicadoData1Leitura | Text | Date of first stamp in DD/MM/YYYY HH:MM:SS + (HLB) format |
| EVID | Text | Valid Email ID for this email |
| Anexos | Node for defining attached files. If it does not exist, it means that the email does not contain any attachments | |
| Anexo | Node for attachment file definition. For each file, a node like this will be created. | |
| NomeAnexo | Text | Attachment Filename |
| AnexoLido | Text | S for attachment read by recipient and N for unread. |
| AnexoLidoData1Leitura | Text | Date of the first reading of the attachment in DD/MM/YYYY HH:MM:SS + (HLB) format |