Skip to content

WS015 - Send NF-e to Comprovai

Objective

This integration aims to allow the sending of an NF-e to be tracked by Comprovei©.

Important

By default, an NF-e sent to Comprovai will be treated as a Document. However, through a parameter, It is possible to configure the NF-e to be treated as a DANFE, being necessary to import a CT-e to finalize the link and create a Document.

Method description
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

Important

  1. The connection to our service must be made to our main server, however we strongly suggest that a connection to our contingency server is also made available, as a guarantee of the availability of our services. The contingency server is only turned on in situations where our main server is unavailable. Making the connection url parameterizable is also a good practice;
  2. Our connections are secure using the SSL protocol. For security reasons, our certificates are constantly changed without prior notice. Therefore, it is recommended that you do not develop integrations based on a fixed certificate.
  3. We constantly (and without prior notice) add new fields and structures to both requests and responses from our web services. Anyone who uses our webservices must implement it in such a way that the programs that consume these webservices do not stop working when the mentioned field changes occur.

Features

  • Calls will be made via SOAP over HTTPS;
  • The origin of the Web Service call will be the client's system;

Important

The user of this Web Service must store the protocol generated in the response. Support tickets regarding this integration will require this protocol.

Authentication

  • Calls will have transport-level authentication (Basic Authentication);
  • Request user / password from the account administrator.

Example HTTP header with authentication

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

The request for our Web Service is composed as follows:

TAG Type Description
conteudoArquivo string Contents of the NF-e file encoded in Base64.
nomeArquivo string Name of the sent file, with the extension. Example: nfe33170833000167008862550070002582311450123456.xml

Request Example

<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>

Important

The NF-e in the example is no longer valid before the Revenue because its content has been mischaracterized and, therefore, its cryptographic signature is incorrect.

Response

Our Web Service responds to you as follows:

TAG Type Description
status string Success or error message for the method call.
protocolo string Protocol for checking the progress of the import request.

Protocol

When a file is accepted into our system, a protocol is generated so that the import process can be monitored. This can be done using the WS501 method.

NF-e mapping

The tables below describe the results of the mapping of our Web Service WS015 in relation to WS013.

WS015 WS013
TAG ID, FIELD
TAG ID FIELD DESCRIPTION Standard Value
Tipo - NFe Document type (NFE, OS, CTE, etc.). There is no validation for this information and is for reference only. NFe
TipoParada B06 mod Stop type: for 20 the value defined is 'C' (Collection) and the others are 'E' (Delivery). 'C' or 'E'
Modelo B06 mod Tax model of the document (check with SEFAZ for available models). -
Numero B08 nNF Document number. Only numbers without special characters or spaces. -
Valor W16 vNF Total value of the document. -
Serie B07 series Document series (in the case of NFe). If not, send value 0. 0
Emissao B09 dhEmi Date of issue of the document. The format YYYYMMDD is mandatory. -
Atualização B10 dhSaiEnt Document update date. The format YYYYMMDD is mandatory. -
Chave A03 Id Document key. Normally it is the tax document key (barcode). This field is mandatory and its content must be unique for different documents. -
cnpj E02/EO3 CNPJ/CPF CNPJ (or CPF) of the recipient of the document. (numbers only). -
cnpjEmissor B17/C02 CNPJ/CNPJ CNPJ of the document issuer and/or shipper. (numbers only). -
cnpjTransportador X04 CNPJ CNPJ of the transporter. (numbers only). -
cnpjConsignatario - - CNPJ of the Consignee. (numbers only). -
Romaneio - - Document mailing number. -
Remessa - - Document shipping number. -
Pedido - - Document order number. -
Placa - - Vehicle plate associated with the document. -
Filial - - Branch associated with the document. -
Peso X32 weightB Gross loading weight of the document. -
Cubagem - - Total document load volume. -
ONU - - Document load hazard code. -
Agendamento - - Document scheduling date. -
PesoLíquido X31 weightL Net weight of the document load. -
Volume X27 qVol Number of document volumes. -
Route:
  • Name
  • Date

  • Driver

-
-

-

-
-

-
  • Name
  • Date of the route, in YYYYMMDD format.
  • Code of the driver responsible for the route.

-
-

-
Window
  • StartTime
  • EndTime

-
-

-
-		 Delivery Window
  • Start date and time.
  • End date and time

-
-
Tipo de Material - - Document material type. -
Fornecimento - - Document supply code. -
TipoFrete - - Type of freight contracted for the document. -
Modal
  • Sla
    • DiasUte
    -
    -
    Mode of transport contracted for the document.
    -
    Cliente
  • Codigo
    		•  E02/E03 CNPJ/CPF CNPJ (or CPF) of the recipient of the document. (numbers only). -
  • internal code
    		•  - - Internal or alternative customer code. -
  • Contact
    		•  E04 xName Corporate name or name of recipient. -
  • Telephone
    		•  E16 phone Telephone. -
  • Email
    		•  E19 email Email. -
  • Reason
    		•  E04 xName Corporate name or name of recipient. -
  • Address
    		•  E06, E07, E08 xLgr, nro, xCpl xLgr (Street), nro(Number) and xCpl(Complement). -
  • Neighborhood
    		•  E09 xBairro Neighborhood. -
  • City
    		•  E11 xMun Name of the municipality. -
  • State
    		•  E12 UF UF acronym. -
  • Country
    		•  E15 xCountry Country Name. -
  • CEP
    		•  E13 CEP CEP Code. -
  • Region
    		•  - - Region or branch or route of the delivery address. -
  • ClientType
    		•  - - Free field to differentiate, in the system, whether the client in question is special or common. -
  • Message
    		•  - - Informative text for the driver about the customer. Ex. Deliver NO 2nd. Room 21 -
  • gerentecodigo
    		•  - - Account manager code. -
  • managername
    		•  - - Name of account manager. -
  • emailmanager
    		•  - - Email account of the account manager. -
  • mobile manager
    		•  - - Account manager's cell phone in the format DDDNNNNNNNNN. -
  • supervidorcodigo
    		•  - - Account supervisor code. -
  • supervisorname
    		•  - - Name of account supervisor. -
  • supervisoremail
    		•  - - Email account of the account supervisor. -
  • supervisorcellphone
    		•  - - Account supervisor's cellphone in the format DDDNNNNNNNNN. -
  • codigoIBGE
    		•  E10 cMun Municipality code. -
    Danfes
  • danfe
    		•
        • serieDanfe
    		 - - NF-e series. -
        • chavedanfe
    		 - - NF-e key. -
        • dataemissaodanfe
    		 - - Date of issue of this NF-e, in the format DDDNNNNNNNNN. -
    SKUs
  • Sku
    		•
        • Gross Weight
    		 - - Gross Weight. 0
        • Net Weight
    		 - - Net Weight. 0
        • Volumes
    		 - - Volumes. 1
        • Description
    		 I04 xProd Description of the product or service. -
        • Qde
    		 I10 qCom Commercial Quantity. -
        • Uom
    		 I09 uCom Commercial Unit. -
        • Barcode
    		 I12 cENTrib GTIN (Global Trade Item Number) of the taxable unit, former EAN code or barcode. -

    Important

    The tags referring to the TAG field in the table above are descendants of the parent Documents tag and the child Document tag in WS015.

    Response Example

    <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>