Pular para conteúdo

WS015 - Enviar NF-e para Comprovei

Objetivo

Esta integração tem por objetivo permitir o envio de uma NF-e para que seja rastreada pela Comprovei©.

Importante

Por padrão, uma NF-e enviada para a Comprovei será tratada como um Documento. Porém, através de um parâmetro, é possível configurar que a NF-e seja tratada como uma DANFE, sendo necessário importar um CT-e para finalizar o vínculo e criar um Documento.

Descrição do método
Método uploadNFe
WSDL principal https://soap.comprovei.com.br/importQueue/index.php?wsdl
WSDL de contingencia https://soapcontingencia.comprovei.com.br/importQueue/index.php?wsdl

Importante

  1. A conexão ao nosso serviço deve ser feito ao nosso servidor principal, porém sugerimos fortemente que também seja disponibilizada uma conexão ao nosso servidor de contingência, como garantia de disponibilidade dos nossos serviços. O servidor de contingência só é ligado em situações de indisponibilidade do nosso servidor principal. Tornar parametrizável a url de conexão também é uma boa prática;
  2. Nossas conexões são seguras utilizando o protocolo SSL. Por questão de segurança nossos certificados são alterados constantemente e sem aviso prévio. Portanto é recomendável que não desenvolvam as integrações baseadas em um certificado fixo.
  3. Constantemente (e sem aviso prévio) adicionamos novos campos e estruturas tanto nas requisições quanto nas respostas dos nossos webservices. Quem for utilizar nossos webservices deve implementar de tal maneira que os programas que consomem estes webservices não deixem de funcionar quando houver as alterações de campos mencionadas.

Características

  • As chamadas serão realizadas via SOAP sobre HTTPS;
  • A origem do chamado do Web Service será o sistema do cliente;

Importante

O usuário deste Web Service deve armazenar o protocolo gerado na resposta. Chamados de suporte referentes a esta integração irão necessitar deste protocolo.

Autenticação

  • As chamadas terão autenticação a nível de transporte (Basic Authentication);
  • Solicite o user / password ao administrador da conta.

Exemplo cabeçalho HTTP com a autenticação

POST https://soap.comprovei.com.br/importQueue/index.php HTTP/1.1
Accept-Encoding: gzip,deflate
Content-Type: text/xml;charset=UTF-8
SOAPAction: "urn:WebServiceComprovei#uploadNFe"
Authorization: Basic BASE64(user:password)
Content-Length: {quantidade de bytes enviados}
Host: soap.comprovei.com.br
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)

Request

A requisição para o nosso Web Service é composta da seguinte forma:

TAG Tipo Descrição
conteudoArquivo string Conteúdo do arquivo NF-e codificado em Base64.
nomeArquivo string Nome do arquivo enviado, com a extensão. Exemplo: nfe33170833000167008862550070002582311450123456.xml

Exemplo de Request

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:WebServiceComprovei">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:uploadNFe soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <conteudoArquivo xsi:type="xsd:string">PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxuZmVQcm9jIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIiB2ZXJzYW89IjMuMTAiPg0KICAgPE5GZT4NCiAgICAgIDxpbmZORmUgdmVyc2FvPSIzLjEwIiBJZD0iTkZlMzMxNzA4MzMwMDAxNjcwMDg4NjI1NTAwNzAwMDI1ODIzMTE0NTAxMjM0NTYiPg0KICAgICAgICAgPGlkZT4NCiAgICAgICAgICAgIDxjVUY+MzM8L2NVRj4NCiAgICAgICAgICAgIDxjTkY+NDUwNDIyOTg8L2NORj4NCiAgICAgICAgICAgIDxuYXRPcD5WZW5kYSBDb250cmEgRW50cmVnYSAoUHJvZHV0byBRdW90YWRvKTwvbmF0T3A+DQogICAgICAgICAgICA8aW5kUGFnPjE8L2luZFBhZz4NCiAgICAgICAgICAgIDxtb2Q+NTU8L21vZD4NCiAgICAgICAgICAgIDxzZXJpZT43PC9zZXJpZT4NCiAgICAgICAgICAgIDxuTkY+MTIzNDU2Nzwvbk5GPg0KICAgICAgICAgICAgPGRoRW1pPjIwMTktMDEtMDdUMTg6MjI6MDAtMDM6MDA8L2RoRW1pPg0KICAgICAgICAgICAgPGRoU2FpRW50PjIwMTktMDEtMDdUMTg6MjI6MDAtMDM6MDA8L2RoU2FpRW50Pg0KICAgICAgICAgICAgPHRwTkY+MTwvdHBORj4NCiAgICAgICAgICAgIDxpZERlc3Q+MjwvaWREZXN0Pg0KICAgICAgICAgICAgPGNNdW5GRz5Db2RpZ29NdW5pY2lwaW88L2NNdW5GRz4NCiAgICAgICAgICAgIDx0cEltcD4xPC90cEltcD4NCiAgICAgICAgICAgIDx0cEVtaXM+MTwvdHBFbWlzPg0KICAgICAgICAgICAgPGNEVj4yPC9jRFY+DQogICAgICAgICAgICA8dHBBbWI+MTwvdHBBbWI+DQogICAgICAgICAgICA8ZmluTkZlPjE8L2Zpbk5GZT4NCiAgICAgICAgICAgIDxpbmRGaW5hbD4wPC9pbmRGaW5hbD4NCiAgICAgICAgICAgIDxpbmRQcmVzPjk8L2luZFByZXM+DQogICAgICAgICAgICA8cHJvY0VtaT4wPC9wcm9jRW1pPg0KICAgICAgICAgICAgPHZlclByb2M+Ni4wPC92ZXJQcm9jPg0KICAgICAgICAgPC9pZGU+DQogICAgICAgICA8ZW1pdD4NCiAgICAgICAgICAgIDxDTlBKPjEyMzQ1Njc4OTAxMjM0PC9DTlBKPg0KICAgICAgICAgICAgPHhOb21lPk5vbWVFbWlzc29yPC94Tm9tZT4NCiAgICAgICAgICAgIDx4RmFudD5GYW50YXNpYUVtaXNzb3I8L3hGYW50Pg0KICAgICAgICAgICAgPGVuZGVyRW1pdD4NCiAgICAgICAgICAgICAgIDx4TGdyPkxvZ3JhZG91cm9FbWlzc29yPC94TGdyPg0KICAgICAgICAgICAgICAgPG5ybz5OdW1lcm9FbWlzc29yPC9ucm8+DQogICAgICAgICAgICAgICA8eENwbD5Db21wbGVtZW50b0VtaXNzb3I8L3hDcGw+DQogICAgICAgICAgICAgICA8eEJhaXJybz5CYWlycm9FbWlzc29yPC94QmFpcnJvPg0KICAgICAgICAgICAgICAgPGNNdW4+Q29kaWdvTXVuaWNpcGlvRW1pc3NvcjwvY011bj4NCiAgICAgICAgICAgICAgIDx4TXVuPk11bmljaXBpb0VtaXNzb3I8L3hNdW4+DQogICAgICAgICAgICAgICA8VUY+VUZFbWlzc29yPC9VRj4NCiAgICAgICAgICAgICAgIDxDRVA+Q0VQRW1pc3NvcjwvQ0VQPg0KICAgICAgICAgICAgICAgPGNQYWlzPkNvZGlnb1BhaXNFbWlzc29yPC9jUGFpcz4NCiAgICAgICAgICAgICAgIDx4UGFpcz5CcmFzaWw8L3hQYWlzPg0KICAgICAgICAgICAgPC9lbmRlckVtaXQ+DQogICAgICAgICAgICA8SUU+MTIzNDU2Nzg8L0lFPg0KICAgICAgICAgICAgPElFU1Q+MTIzNDU2Nzg5MDEyMzwvSUVTVD4NCiAgICAgICAgICAgIDxDUlQ+MzwvQ1JUPg0KICAgICAgICAgPC9lbWl0Pg0KICAgICAgICAgPGRlc3Q+DQogICAgICAgICAgICA8Q05QSj4xMjM0NTY3ODkwMTIzNDwvQ05QSj4NCiAgICAgICAgICAgIDx4Tm9tZT5Ob21lRGVzdGluYXRhcmlvPC94Tm9tZT4NCiAgICAgICAgICAgIDxlbmRlckRlc3Q+DQogICAgICAgICAgICAgICA8eExncj5Mb2dyYWRvdXJvRGVzdGluYXRhcmlvPC94TGdyPg0KICAgICAgICAgICAgICAgPG5ybz5OdW1lcm9EZXN0aW5hdGFyaW88L25ybz4NCiAgICAgICAgICAgICAgIDx4QmFpcnJvPkJhaXJyb0Rlc3RpbmF0YXJpbzwveEJhaXJybz4NCiAgICAgICAgICAgICAgIDxjTXVuPkNvZGlnb011bmljaXBpb0Rlc3RpbmF0YXJpbzwvY011bj4NCiAgICAgICAgICAgICAgIDx4TXVuPk11bmljaXBpRGVzdGluYXRhcmlvPC94TXVuPg0KICAgICAgICAgICAgICAgPFVGPlVGRGVzdGluYXRhcmlvPC9VRj4NCiAgICAgICAgICAgICAgIDxDRVA+Q0VQRGVzdGluYXRhcmlvPC9DRVA+DQogICAgICAgICAgICAgICA8Y1BhaXM+Q29kaWdvUGFpc0Rlc3RpbmF0YXJpbzwvY1BhaXM+DQogICAgICAgICAgICAgICA8eFBhaXM+QnJhc2lsPC94UGFpcz4NCiAgICAgICAgICAgIDwvZW5kZXJEZXN0Pg0KICAgICAgICAgICAgPGluZElFRGVzdD4xPC9pbmRJRURlc3Q+DQogICAgICAgICAgICA8SUU+MTIzNDU2Nzg5MDEyMzwvSUU+DQogICAgICAgICA8L2Rlc3Q+DQogICAgICAgICA8ZGV0IG5JdGVtPSIxIj4NCiAgICAgICAgICAgIDxwcm9kPg0KICAgICAgICAgICAgICAgPGNQcm9kPkNvZGlnb1Byb2Q8L2NQcm9kPg0KICAgICAgICAgICAgICAgPGNFQU4vPg0KICAgICAgICAgICAgICAgPHhQcm9kPkRlc2NQcm9kdXRvPC94UHJvZD4NCiAgICAgICAgICAgICAgIDxOQ00+MjcxMDE5MzE8L05DTT4NCiAgICAgICAgICAgICAgIDxDRVNUPjA2MDA3MDA8L0NFU1Q+DQogICAgICAgICAgICAgICA8Q0ZPUD42NjUxPC9DRk9QPg0KICAgICAgICAgICAgICAgPHVDb20+TDwvdUNvbT4NCiAgICAgICAgICAgICAgIDxxQ29tPjMwMDAwLjAwMDA8L3FDb20+DQogICAgICAgICAgICAgICA8dlVuQ29tPjIuMzk2MjM4NjY2NzwvdlVuQ29tPg0KICAgICAgICAgICAgICAgPHZQcm9kPjcxODg3LjE2PC92UHJvZD4NCiAgICAgICAgICAgICAgIDxjRUFOVHJpYiAvPg0KICAgICAgICAgICAgICAgPHVUcmliPk0zPC91VHJpYj4NCiAgICAgICAgICAgICAgIDxxVHJpYj4zMC4wMDAwPC9xVHJpYj4NCiAgICAgICAgICAgICAgIDx2VW5UcmliPjIzOTYuMjM4NjY2NjY2NzwvdlVuVHJpYj4NCiAgICAgICAgICAgICAgIDxpbmRUb3Q+MTwvaW5kVG90Pg0KICAgICAgICAgICAgICAgPHhQZWQ+MTE1NTEyNzE8L3hQZWQ+DQogICAgICAgICAgICAgICA8Y29tYj4NCiAgICAgICAgICAgICAgICAgIDxjUHJvZEFOUD42MTAxMDEwMDI8L2NQcm9kQU5QPg0KICAgICAgICAgICAgICAgICAgPHFUZW1wPjMxMzc3LjAwMDA8L3FUZW1wPg0KICAgICAgICAgICAgICAgICAgPFVGQ29ucz5NRzwvVUZDb25zPg0KICAgICAgICAgICAgICAgICAgPENJREU+DQogICAgICAgICAgICAgICAgICAgICA8cUJDUHJvZD4wLjAwMDA8L3FCQ1Byb2Q+DQogICAgICAgICAgICAgICAgICAgICA8dkFsaXFQcm9kPjAuMDAwMDwvdkFsaXFQcm9kPg0KICAgICAgICAgICAgICAgICAgICAgPHZDSURFPjAuMDA8L3ZDSURFPg0KICAgICAgICAgICAgICAgICAgPC9DSURFPg0KICAgICAgICAgICAgICAgPC9jb21iPg0KICAgICAgICAgICAgPC9wcm9kPg0KICAgICAgICAgICAgPGltcG9zdG8+DQogICAgICAgICAgICAgICA8SUNNUz4NCiAgICAgICAgICAgICAgICAgIDxJQ01TNDA+DQogICAgICAgICAgICAgICAgICAgICA8b3JpZz4wPC9vcmlnPg0KICAgICAgICAgICAgICAgICAgICAgPENTVD40MTwvQ1NUPg0KICAgICAgICAgICAgICAgICAgPC9JQ01TNDA+DQogICAgICAgICAgICAgICA8L0lDTVM+DQogICAgICAgICAgICAgICA8SVBJPg0KICAgICAgICAgICAgICAgICAgPGNFbnE+MDA0PC9jRW5xPg0KICAgICAgICAgICAgICAgICAgPElQSU5UPg0KICAgICAgICAgICAgICAgICAgICAgPENTVD41NDwvQ1NUPg0KICAgICAgICAgICAgICAgICAgPC9JUElOVD4NCiAgICAgICAgICAgICAgIDwvSVBJPg0KICAgICAgICAgICAgICAgPFBJUz4NCiAgICAgICAgICAgICAgICAgIDxQSVNBbGlxPg0KICAgICAgICAgICAgICAgICAgICAgPENTVD4wMTwvQ1NUPg0KICAgICAgICAgICAgICAgICAgICAgPHZCQz43MTg4Ny4xNjwvdkJDPg0KICAgICAgICAgICAgICAgICAgICAgPHBQSVM+MS42NTAwPC9wUElTPg0KICAgICAgICAgICAgICAgICAgICAgPHZQSVM+MTE4Ni4xNDwvdlBJUz4NCiAgICAgICAgICAgICAgICAgIDwvUElTQWxpcT4NCiAgICAgICAgICAgICAgIDwvUElTPg0KICAgICAgICAgICAgICAgPENPRklOUz4NCiAgICAgICAgICAgICAgICAgIDxDT0ZJTlNBbGlxPg0KICAgICAgICAgICAgICAgICAgICAgPENTVD4wMTwvQ1NUPg0KICAgICAgICAgICAgICAgICAgICAgPHZCQz43MTg4Ny4xNjwvdkJDPg0KICAgICAgICAgICAgICAgICAgICAgPHBDT0ZJTlM+Ny42MDAwPC9wQ09GSU5TPg0KICAgICAgICAgICAgICAgICAgICAgPHZDT0ZJTlM+NTQ2My40MjwvdkNPRklOUz4NCiAgICAgICAgICAgICAgICAgIDwvQ09GSU5TQWxpcT4NCiAgICAgICAgICAgICAgIDwvQ09GSU5TPg0KICAgICAgICAgICAgPC9pbXBvc3RvPg0KICAgICAgICAgICAgPGluZkFkUHJvZD48L2luZkFkUHJvZD4NCiAgICAgICAgIDwvZGV0Pg0KICAgICAgICAgPHRvdGFsPg0KICAgICAgICAgICAgPElDTVNUb3Q+DQogICAgICAgICAgICAgICA8dkJDPjAuMDA8L3ZCQz4NCiAgICAgICAgICAgICAgIDx2SUNNUz4wLjAwPC92SUNNUz4NCiAgICAgICAgICAgICAgIDx2SUNNU0Rlc29uPjAuMDA8L3ZJQ01TRGVzb24+DQogICAgICAgICAgICAgICA8dkJDU1Q+MC4wMDwvdkJDU1Q+DQogICAgICAgICAgICAgICA8dlNUPjAuMDA8L3ZTVD4NCiAgICAgICAgICAgICAgIDx2UHJvZD43MTg4Ny4xNjwvdlByb2Q+DQogICAgICAgICAgICAgICA8dkZyZXRlPjAuMDA8L3ZGcmV0ZT4NCiAgICAgICAgICAgICAgIDx2U2VnPjAuMDA8L3ZTZWc+DQogICAgICAgICAgICAgICA8dkRlc2M+MC4wMDwvdkRlc2M+DQogICAgICAgICAgICAgICA8dklJPjAuMDA8L3ZJST4NCiAgICAgICAgICAgICAgIDx2SVBJPjAuMDA8L3ZJUEk+DQogICAgICAgICAgICAgICA8dlBJUz4xMTg2LjE0PC92UElTPg0KICAgICAgICAgICAgICAgPHZDT0ZJTlM+NTQ2My40MjwvdkNPRklOUz4NCiAgICAgICAgICAgICAgIDx2T3V0cm8+MC4wMDwvdk91dHJvPg0KICAgICAgICAgICAgICAgPHZORj43MTg4Ny4xNjwvdk5GPg0KICAgICAgICAgICAgPC9JQ01TVG90Pg0KICAgICAgICAgPC90b3RhbD4NCiAgICAgICAgIDx0cmFuc3A+DQogICAgICAgICAgICA8bW9kRnJldGU+MTwvbW9kRnJldGU+DQogICAgICAgICAgICA8dHJhbnNwb3J0YT4NCiAgICAgICAgICAgICAgIDxDTlBKPjEyMzQ1Njc4OTAxMjM0PC9DTlBKPg0KICAgICAgICAgICAgICAgPHhOb21lPk5vbWVUcmFuc3BvcnRhZG9yYTwveE5vbWU+DQogICAgICAgICAgICAgICA8SUU+ODQwODk0Nzg8L0lFPg0KICAgICAgICAgICAgICAgPHhFbmRlcj5FbmRlcmVjb1RyYW5zcG9ydGFkb3JhPC94RW5kZXI+DQogICAgICAgICAgICAgICA8eE11bj5NdW5pY2lwaW9UcmFuc3BvcnRhZG9yYTwveE11bj4NCiAgICAgICAgICAgICAgIDxVRj5VRlRyYW5zcG9ydGFkb3JhPC9VRj4NCiAgICAgICAgICAgIDwvdHJhbnNwb3J0YT4NCiAgICAgICAgICAgIDx2ZWljVHJhbnNwPg0KICAgICAgICAgICAgICAgPHBsYWNhPkNZUjI1MjI8L3BsYWNhPg0KICAgICAgICAgICAgICAgPFVGPlNQPC9VRj4NCiAgICAgICAgICAgIDwvdmVpY1RyYW5zcD4NCiAgICAgICAgICAgIDx2b2w+DQogICAgICAgICAgICAgICA8cVZvbD4wPC9xVm9sPg0KICAgICAgICAgICAgICAgPGVzcD5HUkFORUw8L2VzcD4NCiAgICAgICAgICAgICAgIDxwZXNvTD4yNjEzMC4wMDA8L3Blc29MPg0KICAgICAgICAgICAgICAgPHBlc29CPjI2MTMwLjAwMDwvcGVzb0I+DQogICAgICAgICAgICA8L3ZvbD4NCiAgICAgICAgIDwvdHJhbnNwPg0KICAgICAgICAgPGNvYnI+DQogICAgICAgICAgICA8ZmF0Pg0KICAgICAgICAgICAgICAgPG5GYXQ+MDkwNjExNjk5MzwvbkZhdD4NCiAgICAgICAgICAgICAgIDx2T3JpZz43MTg4Ny4xNjwvdk9yaWc+DQogICAgICAgICAgICAgICA8dkxpcT43MTg4Ny4xNjwvdkxpcT4NCiAgICAgICAgICAgIDwvZmF0Pg0KICAgICAgICAgICAgPGR1cD4NCiAgICAgICAgICAgICAgIDxuRHVwPjAwMDAwMDAwMDA8L25EdXA+DQogICAgICAgICAgICAgICA8ZFZlbmM+MjAxNy0wOS0xMDwvZFZlbmM+DQogICAgICAgICAgICAgICA8dkR1cD43MTg4Ny4xNjwvdkR1cD4NCiAgICAgICAgICAgIDwvZHVwPg0KICAgICAgICAgPC9jb2JyPg0KICAgICAgICAgPGluZkFkaWM+DQogICAgICAgICAgICA8aW5mQ3BsPjwvaW5mQ3BsPg0KICAgICAgICAgICAgPG9ic0NvbnQgeENhbXBvPSJDQU5BTENMSUVOVEUiPg0KICAgICAgICAgICAgICAgPHhUZXh0bz5DLlRyYW5zcC46IFJvZG92aWFyaW88L3hUZXh0bz4NCiAgICAgICAgICAgIDwvb2JzQ29udD4NCiAgICAgICAgIDwvaW5mQWRpYz4NCiAgICAgIDwvaW5mTkZlPg0KICAgICAgPFNpZ25hdHVyZSB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyI+DQogICAgICAgICA8U2lnbmVkSW5mbz4NCiAgICAgICAgICAgIDxDYW5vbmljYWxpemF0aW9uTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvVFIvMjAwMS9SRUMteG1sLWMxNG4tMjAwMTAzMTUiIC8+DQogICAgICAgICAgICA8U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnI3JzYS1zaGExIiAvPg0KICAgICAgICAgICAgPFJlZmVyZW5jZSBVUkk9IiNORmUzMzE3MDgzMzAwMDE2NzAwODg2MjU1MDA3MDAwMjU4MjMxMTQ1MDEyMzQ1NiI+DQogICAgICAgICAgICAgICA8VHJhbnNmb3Jtcz4NCiAgICAgICAgICAgICAgICAgIDxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjZW52ZWxvcGVkLXNpZ25hdHVyZSIgLz4NCiAgICAgICAgICAgICAgICAgIDxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz4NCiAgICAgICAgICAgICAgIDwvVHJhbnNmb3Jtcz4NCiAgICAgICAgICAgICAgIDxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIgLz4NCiAgICAgICAgICAgICAgIDxEaWdlc3RWYWx1ZT5ld0FPNkVSMGtGbnZEdjg3OGRlRGs0RkpKZ289PC9EaWdlc3RWYWx1ZT4NCiAgICAgICAgICAgIDwvUmVmZXJlbmNlPg0KICAgICAgICAgPC9TaWduZWRJbmZvPg0KICAgICAgICAgPFNpZ25hdHVyZVZhbHVlPlBPUHRlb2Jhb2VLclZJcmRFTlpKWSt1d2dLZHB6ckh4UXJHTmNGY1hXRjdrWUI4eWhldHY1RUJmZEVTcG0zR21wYUVScWFjZTgxWDYmYW1wOyN4QTtDL1huVHhOK2N0TzNPWjd6ZVlKbUZJTWJmU2hhbUUrNzNDN2VXOThQckV0MkIyVUpwamh2OFFvSHdSTDBiUFU4aVhXUmNBekROUitFJmFtcDsjeEE7cmxjYlRNQmxlcVpjN2RkTnJFUUlRcHRoV0pLTERRbWxKWUN1ZXB6eVNGeXN0VnRONmxDalo4YmRxVTdZbVZkZEZHd0xUdkxXVXVvWCZhbXA7I3hBOytaVStIZEpXcndtY1FsM215dUt5b3gvbkpERTZ2dmFjd05nNTV5aXpqU0RqSVd1QkdpZVluRzY3QU5Qb3VTNXVjY3ZIcENkRmlNRjUmYW1wOyN4QTs4TmxRZXBvTktyd2trMlNZSENrTEpqdDRCZmV2ODZKYVhyZjQ2UT09PC9TaWduYXR1cmVWYWx1ZT4NCiAgICAgICAgIDxLZXlJbmZvPg0KICAgICAgICAgICAgPFg1MDlEYXRhPg0KICAgICAgICAgICAgICAgPFg1MDlDZXJ0aWZpY2F0ZT5NSUlIK3pDQ0JlT2dBd0lCQWdJUVdhekpuYnBWOHRFMnAyc1hjQnFHVWpBTkJna3Foa2lHOXcwQkFRc0ZBREIwTVFzd0NRWURWUVFHJmFtcDsjeEE7RXdKQ1VqRVRNQkVHQTFVRUNoTUtTVU5RTFVKeVlYTnBiREV0TUNzR0ExVUVDeE1rUTJWeWRHbHphV2R1SUVObGNuUnBabWxqWVdSdiZhbXA7I3hBO2NtRWdSR2xuYVhSaGJDQlRMa0V1TVNFd0h3WURWUVFERXhoQlF5QkRaWEowYVhOcFoyNGdUWFZzZEdsd2JHRWdSemN3SGhjTk1UY3cmYW1wOyN4QTtNekUyTVRReU16UTJXaGNOTVRnd016RTJNVFF5TXpRMldqQ0J2ekVMTUFrR0ExVUVCaE1DUWxJeEV6QVJCZ05WQkFvTUNrbERVQzFDJmFtcDsjeEE7Y21GemFXd3hKVEFqQmdOVkJBc01IRUYxZEdWdWRHbGpZV1J2SUhCdmNpQkJVaUJqWlhKMGFYTnBaMjR4R3pBWkJnTlZCQXNNRWtGeiZhbXA7I3hBO2MybHVZWFIxY21FZ1ZHbHdieUJCTVRFcU1DZ0dBMVVFQXd3aFVFVlVVazlNUlU4Z1FsSkJVMGxNUlVsU1R5QlRJRUVnVUVWVVVrOUMmYW1wOyN4QTtVa0ZUTVNzd0tRWUpLb1pJaHZjTkFRa0JGaHhoWTJGMllXeGpZVzUwYVVCd1pYUnliMkp5WVhNdVkyOXRMbUp5TUlJQklqQU5CZ2txJmFtcDsjeEE7aGtpRzl3MEJBUUVGQUFPQ0FROEFNSUlCQ2dLQ0FRRUFvb0pzR2FlUHQzYjc3Sk81aHFUS0dUZ1luWlFDZ0J1N1Uxa0JMc0F5eXd5cyZhbXA7I3hBO0Iyd2VaSlVZdzZpdWZtVTRtS2JMKzVqcURJbjd2RmRGRTdyai8rdGJCazJ6VWg4NTVSNTlobWVWT2hmdmh4VWt5Mnd6aDhQYUQ4cmQmYW1wOyN4QTsvVG5XM3R0S0NpRXRlZWNEdWVlT3ZXQlNDSjZTSXdDSm43eXJxYWhFSG5NMXBVR1FQeExuVGxQZGZsUk1sM0RTaWVyZm9WaURGUUNOJmFtcDsjeEE7aFpCNE1KY3psakpUM2ljN2FXTzlSMGxaUkFUQ2dhb3FYaDFsRnJibk9wbWNONkEzcFJoVHArODdndUJiK3BtYnk1cWpxU2JCbll4eSZhbXA7I3hBO1N0RlVCM0QxMXlyYkt5S201Nm1yZHd1ZzdyS2RQZlkxeVY5NDN1SUx1MkdjcEMvMld6czYwR25taEVKTGFUZ0tmYk1sRHdJREFRQUImYW1wOyN4QTtvNElET3pDQ0F6Y3dnY2tHQTFVZEVRU0J3VENCdnFBOUJnVmdUQUVEQktBMEJESXhNakF6TVRrM056ZzNPRGMwTnpZNE5URTFNREF3JmFtcDsjeEE7TURBd01EQXdNREF3TURBd01EQTFPVGswTXpVNU9USlRVMUJDUWFBckJnVmdUQUVEQXFBaUJDQkJibVJsY25OdmJpQkdZV2R1WlhJZyZhbXA7I3hBO1UyOTFlbUVnUTJGMllXeGpZVzUwYWFBWkJnVmdUQUVEQTZBUUJBNHpNekF3TURFMk56QXdNREV3TWFBWEJnVmdUQUVEQjZBT0JBd3cmYW1wOyN4QTtNREF3TURBd01EQXdNRENCSEdGallYWmhiR05oYm5ScFFIQmxkSEp2WW5KaGN5NWpiMjB1WW5Jd0NRWURWUjBUQkFJd0FEQWZCZ05WJmFtcDsjeEE7SFNNRUdEQVdnQlJkY2d5L005Szc0NGFtNkV3R2NYNVZYQWVnMWpDQml3WURWUjBnQklHRE1JR0FNSDRHQm1CTUFRSUJDekIwTUhJRyZhbXA7I3hBO0NDc0dBUVVGQndJQkZtWm9kSFJ3T2k4dmFXTndMV0p5WVhOcGJDNWpaWEowYVhOcFoyNHVZMjl0TG1KeUwzSmxjRzl6YVhSdmNtbHYmYW1wOyN4QTtMMlJ3WXk5QlExOURaWEowYVhOcFoyNWZUWFZzZEdsd2JHRXZSRkJEWDBGRFgwTmxjblJwVTJsbmJsOU5kV3gwYVhCc1lTNXdaR1l3JmFtcDsjeEE7Z2NZR0ExVWRId1NCdmpDQnV6QmNvRnFnV0laV2FIUjBjRG92TDJsamNDMWljbUZ6YVd3dVkyVnlkR2x6YVdkdUxtTnZiUzVpY2k5eSZhbXA7I3hBO1pYQnZjMmwwYjNKcGJ5OXNZM0l2UVVORFpYSjBhWE5wWjI1TmRXeDBhWEJzWVVjM0wweGhkR1Z6ZEVOU1RDNWpjbXd3VzZCWm9GZUcmYW1wOyN4QTtWV2gwZEhBNkx5OXBZM0F0WW5KaGMybHNMbTkxZEhKaGJHTnlMbU52YlM1aWNpOXlaWEJ2YzJsMGIzSnBieTlzWTNJdlFVTkRaWEowJmFtcDsjeEE7YVhOcFoyNU5kV3gwYVhCc1lVYzNMMHhoZEdWemRFTlNUQzVqY213d0RnWURWUjBQQVFIL0JBUURBZ1hnTUIwR0ExVWRKUVFXTUJRRyZhbXA7I3hBO0NDc0dBUVVGQndNQ0JnZ3JCZ0VGQlFjREJEQ0J0Z1lJS3dZQkJRVUhBUUVFZ2Frd2dhWXdaQVlJS3dZQkJRVUhNQUtHV0doMGRIQTYmYW1wOyN4QTtMeTlwWTNBdFluSmhjMmxzTG1ObGNuUnBjMmxuYmk1amIyMHVZbkl2Y21Wd2IzTnBkRzl5YVc4dlkyVnlkR2xtYVdOaFpHOXpMMEZEJmFtcDsjeEE7WDBObGNuUnBjMmxuYmw5TmRXeDBhWEJzWVY5SE55NXdOMk13UGdZSUt3WUJCUVVITUFHR01taDBkSEE2THk5dlkzTndMV0ZqTFdObCZhbXA7I3hBO2NuUnBjMmxuYmkxdGRXeDBhWEJzWVM1alpYSjBhWE5wWjI0dVkyOXRMbUp5TUEwR0NTcUdTSWIzRFFFQkN3VUFBNElDQVFBM3BBSDEmYW1wOyN4QTs0RmVxWURleHduQ1RBYzlBRHZLYWlMNW80bUFWZXp3Q2RUR3d1M0tPOUQ4QWVrTU1pQVFvUG43RmRkZFp3N1dreXhTaFJqdFRrVHdJJmFtcDsjeEE7dUZ3bzQ1TjIyK0pDdHVZeVVOR3BBRXZXV01Wckw1bnBVQVY5T05aeGJweFpUb0ZiUWl2VDJlenh0UHhRS0FXR2Q5SnUxSjZqcUQ0OCZhbXA7I3hBO0ZVVUxQMnU4Y3BJTTE5WFVURlEzdzZyNjFZR3FsUmtheWo2QVdBTERUeGU5UlFZc3hEVHVLR2g1ZG1GSXBaL3BDNW9CZDVZZWduTVQmYW1wOyN4QTt4Y04zRmc5TWtHcUNENGxDT05ra3ZobnY1cnVhWVhyRVFGcGxqQmlMOG1BZzhyOXpHRXp3cUNHZVRpSVFyVU9XQ3VybWVLSVgzNk1oJmFtcDsjeEE7SlJUbXZGbitSSmRSc2d1NUc1bnpDSDVHODZmdThtSXh0c3JKK1hvZ0ErSk90VDRnT3Ixd2lSYm1Xbm9yWlE1K0REYllFYTBaTENwZCZhbXA7I3hBO2JYY25vK3dhOGwxUXpFQTdCS0lxSWNsQXVvNys1Sm1iUmNabDJraDhVZExFdTlrdGE5Q1BWaXRhWnl2NzIvYUN6SWFPYkhFLzdxSkcmYW1wOyN4QTtGVm5yWVl1dFA2QVduc3YxL2FNTGEzd3IyS0M0N0w0YTA1bis5eVNteDZEMHozU1VXMmtMaWR4SGlMZU8wbTRTTkZvV2NzOXZ4eVRNJmFtcDsjeEE7akdPWE5nWGpHOE5pYjl1dU5nUnJJMGpZYi9lWDdSbFNaWDRBcUsvSm9KMjFKenYwY0ErWElkRytFR1ZqR1UxM2dscUlzekdzYkQ2bSZhbXA7I3hBOyt3MGU2RktNMStTWkZFTkg0WExjbnZwZUlsTDNweUtEd1Q4K0JLSUFicGlEVGxic29LS3gzLytJMER2dGZHVmxKeklscnc9PTwvWDUwOUNlcnRpZmljYXRlPg0KICAgICAgICAgICAgPC9YNTA5RGF0YT4NCiAgICAgICAgIDwvS2V5SW5mbz4NCiAgICAgIDwvU2lnbmF0dXJlPg0KICAgPC9ORmU+DQogICA8cHJvdE5GZSB2ZXJzYW89IjMuMTAiPg0KICAgICAgPGluZlByb3Q+DQogICAgICAgICA8dHBBbWI+MTwvdHBBbWI+DQogICAgICAgICA8dmVyQXBsaWM+U1ZSUzIwMTcwNjI4MTExNjwvdmVyQXBsaWM+DQogICAgICAgICA8Y2hORmU+MzMxNzA4MzMwMDAxNjcwMDg4NjI1NTAwNzAwMDI1ODIzMTE0NTAxMjM0NTY8L2NoTkZlPg0KICAgICAgICAgPGRoUmVjYnRvPjIwMTktMDEtMDcxODoyMzo0Mi0wMzowMDwvZGhSZWNidG8+DQogICAgICAgICA8blByb3Q+MTIzNDU2Nzg5MDEyMzQ1PC9uUHJvdD4NCiAgICAgICAgIDxkaWdWYWw+ZXdBTzZFUjBrRm52RHY4NzhkZURrNEZKSmdvPTwvZGlnVmFsPg0KICAgICAgICAgPGNTdGF0PjEwMDwvY1N0YXQ+DQogICAgICAgICA8eE1vdGl2bz5BdXRvcml6YWRvIG8gdXNvIGRhIE5GLWU8L3hNb3Rpdm8+DQogICAgICA8L2luZlByb3Q+DQogICA8L3Byb3RORmU+DQo8L25mZVByb2M+</conteudoArquivo>
         <nomeArquivo xsi:type="xsd:string">nfe33170833000167008862550070002582311450123456.xml</nomeArquivo>
      </urn:uploadNFe>
   </soapenv:Body>
</soapenv:Envelope>

Importante

A NF-e do exemplo não é mais válida perante a Receita pois seu conteúdo foi descaracterizado e, portanto, sua assinatura criptográfica está incorreta.

Response

Nosso Web Service responde para você da seguinte forma:

TAG Tipo Descrição
status string Mensagem de sucesso ou de erro para a chamada do método.
protocolo string Protocolo para consultar a evolução do pedido de importação.

Protocolo

Quando um arquivo é aceito no nosso sistema, um protocolo é gerado para que o processo de importação seja acompanhado. Isso pode ser feito utilizando o método WS501.

Mapeamento NF-e

Nas Tabelas abaixos são descritas os resultados do mapeamento do nosso Web Service WS015 em relação ao WS013.

WS015 WS013
TAG ID, CAMPO
TAG ID CAMPO DESCRIÇÃO Valor Padrão
Tipo - NFe Tipo do documento (NFE, OS, CTE, etc). Não existe validação para esta informação e serve apenas para referência. NFe
TipoParada B06 mod Tipo da parada: para 20 o valor definido fica em 'C' (Coleta) e os demais fica com 'E' (Entrega). 'C' ou 'E'
Modelo B06 mod Modelo fiscal do documento (verificar junto a SEFAZ os modelos disponíveis). -
Numero B08 nNF Número do documento. Somente números sem caracteres especiais ou espaços. -
Valor W16 vNF Valor total do documento. -
Serie B07 serie Série do documento (no caso de NFe). Se não tiver, enviar valor 0. 0
Emissao B09 dhEmi Data de emissão do documento. Obrigatório o formato YYYYMMDD. -
Atualização B10 dhSaiEnt Data de atualização do documento. Obrigatório o formato YYYYMMDD. -
Chave A03 Id Chave do documento. Normalmente é a chave do documento fiscal (barcode). Este campo é obrigatório e seu conteúdo deve ser único para documentos diferentes. -
cnpj E02/EO3 CNPJ/CPF CNPJ (ou CPF) do destinatário do documento. (somente números). -
cnpjEmissor B17/C02 CNPJ/CNPJ CNPJ do emitente do documento e/ou do embarcador. (somente números). -
cnpjTransportador X04 CNPJ CNPJ do transportador. (somente números). -
cnpjConsignatario - - CNPJ do Consignatario. (somente números). -
Romaneio - - Número do romaneio do documento. -
Remessa - - Número de remessa do documento. -
Pedido - - Número do pedido do documento. -
Placa - - Placa de veículo associado ao documento. -
Filial - - Filial associada ao documento. -
Peso X32 pesoB Peso bruto de carga do documento. -
Cubagem - - Volume total da carga do documento. -
ONU - - Código de periculosidade da carga do documento. -
Agendamento - - Data de agendamento do documento. -
PesoLíquido X31 pesoL Peso líquido da carga do documento. -
Volume X27 qVol Quantidade de volumes do documentos. -
Rota:
  • Nome
  • Data

  • Motorista

-
-

-

-
-

-
  • Nome
  • Data da rota, no formato YYYYMMDD.
  • Código do motorista responsável pela rota.

-
-

-
Janela
  • DataHoraIni
  • DataHoraFim

-
-

-
-		 Janela de Entrega
  • Data e Hora de início.
  • Data e Hora do Fim

-
-
Tipo de Material - - Tipo de material do documento. -
Fornecimento - - Código de fornecimento do documento. -
TipoFrete - - Tipo de frete contratado para o documento. -
Modal
  • Sla
    • DiasUte
    -
    -
    Modal de transporte contratado para o documento.
    -
    Cliente
  • Codigo
    		•  E02/E03 CNPJ/CPF CNPJ (ou CPF) do destinatário do documento. (somente números). -
  • codigointerno
    		•  - - Código interno ou alternativo do cliente. -
  • Contato
    		•  E04 xNome Razão Social ou nome do destinatário. -
  • Telefone
    		•  E16 fone Telefone. -
  • Email
    		•  E19 email Email. -
  • Razao
    		•  E04 xNome Razão Social ou nome do destinatário. -
  • Endereço
    		•  E06, E07, E08 xLgr, nro, xCpl xLgr (Logradouro), nro(Número) e xCpl(Complemento). -
  • Bairro
    		•  E09 xBairro Bairro. -
  • Cidade
    		•  E11 xMun Nome do município. -
  • Estado
    		•  E12 UF Sigla da UF. -
  • Pais
    		•  E15 xPais Nome do País. -
  • CEP
    		•  E13 CEP Código do CEP. -
  • Região
    		•  - - Região ou filial ou rota do endereço de entrega. -
  • TipoCliente
    		•  - - Campo livre para diferenciar, no sistema, se o cliente em questão é especial ou comum. -
  • Mensagem
    		•  - - Texto informativo para motorista sobre o cliente. Ex. Entregar NO 2and. Sala 21 -
  • gerentecodigo
    		•  - - Código do gerente da conta. -
  • gerentenome
    		•  - - Nome do gerente da conta. -
  • gerenteemail
    		•  - - Conta de email do gerente da conta. -
  • gerentecelular
    		•  - - Celular do gerente da conta no formato DDDNNNNNNNNN. -
  • supervidorcodigo
    		•  - - Código do supervisor da conta. -
  • supervisornome
    		•  - - Nome do supervisor da conta. -
  • supervisoremail
    		•  - - Conta de email do supervisor da conta. -
  • supervisorcelular
    		•  - - Celular do supervisor da conta no formato DDDNNNNNNNNN. -
  • codigoIBGE
    		•  E10 cMun Código do município. -
    Danfes
  • danfe
    		•
        • serieDanfe
    		 - - Série da NF-e. -
        • chavedanfe
    		 - - Chave da NF-e. -
        • dataemissaodanfe
    		 - - Data de emissão desta NF-e, no formato DDDNNNNNNNNN. -
    SKUs
  • Sku
    		•
        • PesoBruto
    		 - - Peso Bruto. 0
        • PesoLiquido
    		 - - Peso Líquido. 0
        • Volumes
    		 - - Volumes. 1
        • Descricao
    		 I04 xProd Descrição do produto ou serviço. -
        • Qde
    		 I10 qCom Quantidade Comercial. -
        • Uom
    		 I09 uCom Unidade Comercial. -
        • Barcode
    		 I12 cENTrib GTIN (Global Trade Item Number) da unidade tributável, antigo código EAN ou código de barras. -

    Importante

    As tags referentes ao campo TAG na tabela acima são descendentes da tag pai Documentos e da tag filha Documento no WS015.

    Exemplo de Response

    <SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:WebServiceComprovei" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
   <SOAP-ENV:Body>
      <ns1:uploadNFeResponse>
         <status xsi:type="xsd:string">Arquivo adicionado para a fila de importação!</status>
         <protocolo xsi:type="xsd:string">2017022258add9af06990</protocolo>
      </ns1:uploadNFeResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>