Através deste endpoint é possível realizar o evento de Comprovação de Entrega de um CT-e já autorizado.
Obs.: O evento de Comprovação de Entrega possui regras e prazos definidos pela Secretaria da Fazendo que devem ser considerados e respeitados. Para maiores informações clique aqui e verifique a versão mais atualizada o Manual de Orientações do Contribuinte da Sefaz.
URL
POST https://cte.ns.eti.br/cte/compentrega
Dados de entrada
| Campos | Descrição | Ocorrência | Tipo | Observação |
|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | 0-1 | A | Pode ser enviado no cabeça |
| chCTe | Chave de acesso do CT-e | 1-1 | N | |
| tpAmb | Tipo do ambiente de autorização do CT-e | 1-1 | N | 1 - Produção 2 - Homologação |
| dhEvento | Data e Hora da emissão do evento | 1-1 | D | Padrão Sefaz (com UTC) AAAA-MM-DDTHH:MM:SS TZD Ex.: 2019-08-09T15:04:10-03:00 |
| nProt | Número do protocolo de autorização do CT-e | 1-1 | N | |
| nSeqEvento | Número sequencial do evento | 1-1 | N | Na maioria dos casos será 1. No entanto quando mais de um evento do mesmo tipo for gerado para o mesmo CT-e, esta numeração deverá ser incrementada de forma sequencial. |
| dhEentrega | Data e Hora da conclusão da entrega | 1-1 | D | Padrão Sefaz (com UTC) AAAA-MM-DDTHH:MM:SS TZD Ex.: 2019-08-09T15:04:10-03:00 |
| nDoc | Documento de identificação da pessoa que recebeu a entrega | 1-1 | A | |
| xNome | Nome da pessoa que recebeu a entrega | 1-1 | A | |
| latitude | Latitude do ponto de entrega | 0-1 | N | Necessárias 6 casas numéricas de precisão |
| longitude | Longitude do ponto de entrega | 0-1 | N | Necessárias 6 casas numéricas de precisão |
| hashEntrega | Hash (SHA1) no formato Base64 resultante da concatenação: Chave de acesso do CT-e + Base64 da imagem capturada da entrega | 1-1 | A | 28 caracteres |
| chavesEntregues | Chaves de acesso das NF-e's que estão sendo entregues | 0-2000 | Array | Informar apenas para CT-e com tipo de serviço Normal |
Exemplo de requisição
Requisição de cancelamento de NF-e
curl -X POST
\-H "Content-Type: application/json"
\-d '{
"X-AUTH-TOKEN": "SEU_TOKEN",
"chCTe": "99999999999999999999999999999999999999999999",
"tpAmb": 2,
"dhEvento": "2019-08-09T19:28:30-03:00",
"nSeqEvento": "1",
"nProt": "999999999999999",
"dhEntrega": "2019-08-09T19:27:40-03:00",
"nDoc": "99999999999",
"xNome": "Nome de Quem Recebeu",
"hashEntrega": "NzgzNkM3QTUwRDZGNg==",
"dhHashEntrega": "2019-08-09T19:28:00-03:00",
"latitude": "-31.776000",
"longitude": "-52.359400",
"chavesEntregues":["99999999999999999999999999999999999999999999","99999999999999999999999999999999999999999999"]
}' \
https://cte.ns.eti.br/cte/compentrega
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| retEvento | Objeto contendo os dados do processamento do CT-e na Sefaz | Somente em status = 200 |
| retEvento.cStat | Código de situação do processamento no Sefaz | |
| retEvento.xMotivo | Descrição literal da situação do processamento na Sefaz | |
| retEvento.chCTe | Chave de acesso do CT-e | |
| retEvento.dhRegEvento | Data e hora de registro do evento na Sefaz | Padrão Sefaz (com UTC): AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2019-08-09T15:04:10-03:00 |
| retEvento.nProt | Número de recibo do documento pela Sefaz | |
| xml | XML de distribuição do evento de comprovante de entrega | Somente em status = 200 |
| erros | Array contendo a lista de erros ocorridos durante a validação das informações do comprovante de acordo com o tipo de dados | Somente em status = -4 |
| codigo | Código do erro ocorrido | Somente em status = -5 |
| descricao | Descrição literal do erro ocorrido | Somente em status = -5 |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Comprovação de Entrega vinculada ao CT-e com sucesso",
"retEvento": {
"cStat": 135,
"xMotivo": "Evento registrado e vinculado a CT-e",
"chCTe": "99999999999999999999999999999999999999999999",
"dhRegEvento": "2019-08-09T19:41:09-03:00","nProt": "999999999999999"
},
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoCTe versao...."}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Comprovação de Entrega vinculada ao CT-e com sucesso |
| -2 | Campos obrigatórios não informados na requisição |
| -3 | Chave de acesso inválida |
| -4 | Erro de informações de acordo com o tipo de dados |
| -5 | Erro ou rejeição ao realizar comprovação de entrega. Verificar os campos codigo e descricao para mais informações |
| -6 | Chave de acesso de NFe informada em inf.Entrega inválida: ( chave de acesso ) |