# Electronic invoice for goods (NFE)

Source: https://developer.avalara.com/tax-docs-en/transactions/electronic_invoice/

# Electronic invoice for goods (NFE)

This section provides an overview of the requirements for using the TaxDocs APIs for Electronic invoice for goods (NFE). Review this section to help you plan your integration.

All calls to our API use HTTPS encrypted environment.

**Using the Avalara APIs you can perform the following operations:**

-   Retrieve the list of electronic invoices
-   Retrieve the content of the electronic invoice
-   Retrieve the XML of the electronic invoice
-   Retrieve the DANFE of the electronic invoice
-   Retrieve the list of canceled invoices
-   Register the Electronic Invoice Manifest event
-   Retrieve the XML of the electronic invoice correction letter

To consult the list of invoices (NFE)

To consult available invoices, you need to use the mandatory parameters`startEntryDate`and`endEntryDate`. Below are other parameters for using the API.

URL: https://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE

**startEntryDate\***  

Sends the invoice entry start date and time within the applicationFormat: YYYY-MM-DDT00:00:00

**endEntryDate\***

Sends the invoice entry end date and time within the applicationFormat: YYYY-MM-DDT00:00:00

**$subscriptionId**

Subscription ID corresponding to the customer for which the query will be made

**$top** 

Sends the maximum amount of invoices that are returned by search

**$skip**

Field used to control the pagination of returns

Example: Returning 0 to 100 in the first query

From 101 to 200 on Monday, and so on until you reach the total "count"

**$filter** 

Can be used for a more specific search

Example: Search for notes of only one CNPJ, among several owned by the client

**$orderby** 

Ordering fields that come in JSON

Example1: Sort by Invoice Key

Example 2: Sort by entry date

**$count**

Shows the amount of existing available notes, according to the requested return parameters

**$select**

To customize which fields are returned in the response

Example: invoiceKey, invoiceNumber, cnpjCpfRecipient

**$expand**

Unsupported option

**$apply**

Unsupported option

\*Asterisk fields are required.

Below is an example of use of the endpoint /api/v1/NFE in cURL using only the required parameters:

```
curl --location --request GET 'http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE?startEntryDate=2021-05-01T12:59:08.714&endEntryDate=2021-05-02T12:59:08.714' \--header 'Authorization: Bearer SEU_TOKEN' \--data-raw ''
```

Example of use of the endpoint /api/v1/NFE in C#:

```
var client = new RestClient("http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE?startEntryDate=2021-05-01T12:59:08.714&endEntryDate=2021-05-02T12:59:08.714");client.Timeout = -1;var request = new RestRequest(Method.GET);request.AddHeader("Authorization", "Bearer SEU TOKEN");var body = @"";request.AddParameter("text/plain", body,  ParameterType.RequestBody);IRestResponse response = client.Execute(request);Console.WriteLine(response.Content);
```

The expected return of the invoice list query contains the parameters below:

-   **invoiceKey**

Invoice access key

-   **invoiceNumber**

Invoice number

-   **cnpjCpfIssuer**

Issuer's CNPJ/CPF 

-   **cnpjCpfRecipient**

Recipient's CNPJ/CPF 

-   **validSefaz**

Return of note status within SEFAZ

True - Document valid at SEFAZ, that is, it is not a canceled or denied document

False - The result of the last query reported that the key refers to a canceled or denied tax document

-   **hasServices**

Field to identify service note

True - The document is an NFSE

False - The document is an NFE

-   **operationType**

0 - Exit

1 - Entry

3 - Transfer

-   **totalInvoice**

Total invoice amount

-   **availableXML**

When the value is "X", tax Document has XML

-   **issueDate**

Tax document issue date

-   **entryDate**

Document entry date in TaxDocs Monitor

-   **cancellationDate**

Tax document cancellation date

-   **validXmlStructure**

True - Document XML is valid

False - Document XML is structurally invalid

Null - There is no XML for the document

The API return is in JSON format as shown below:

```
{ "value": [    { "invoiceKey": "string", "invoiceNumber": 0, "cnpjCpfIssuer": "string", "cnpjCpfRecipient": "string", "validSefaz": true, "hasServices": true, "operationType": 0, "totalInvoice": 0, "availableXML": true, "issueDate": "2021-07-05T18:55:08.704Z", "entryDate": "2021-07-05T18:55:08.704Z", "cancellationDate": "2021-07-05T18:55:08.704Z", "validXmlStructure": true    }  ], "count": 0}
```

To retrieve the content of the electronic invoice (NFE)

To retrieve the content of the electronic invoice, is necessary to know the electronic invoice key.

URL: https://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/{invoiceKey}

**invoiceKey\***

Invoice access key

**subscriptionId**

Subscription ID corresponding to the customer for which the query is made

\*Asterisk fields are required.

Below is an example of use of the endpoint /api/v1/NFE/{invoiceKey} in cURL using only the required parameters:

```
curl --location --request GET 'http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/CHAVE_DA_NOTA' \--header 'Authorization: Bearer SEU TOKEN'
```

Example of using the endpoint /api/v1/NFE/{invoiceKey} in C#:

```
var client = new RestClient("http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/CHAVE_DA_NOTA/");client.Timeout = -1;var request = new RestRequest(Method.GET);request.AddHeader("Authorization", "Bearer SEU TOKEN");var body = @"";request.AddParameter("text/plain", body,  ParameterType.RequestBody);IRestResponse response = client.Execute(request);Console.WriteLine(response.Content);
```

The expected return of the consultation of the electronic invoice content contains the parameters below:

**invoiceKey**

Invoice access key

**invoiceNumber**

Invoice number

**cpfcnpj**

Issuer's CPF/CNPJ

**businessName**

Issuer's business name

**phoneNumber**

Issuer's telephone number

**commercialName**

Issuer's commercial name

**stateRegistration**

Issuer's state registration 

**cityRegistration**

Issuer's municipal registration

**address**

**Issuer's Address Group Information** 

**street**

Name of the issuer's address

**town**

Issuer's city

**state**

Issuer's UF code

**zipCode**

Issuer's zip code

**neighborhood**

Issuer's neighborhood

**complement**

Complement of the issuer's street address

**number**

Issuer's street number

**recipient**

**Recipient's Group Information** 

**cpfcnpj**

Recipient's CPF/CNPJ

**businessName**

Recipient's  business name 

**phoneNumber**

Recipient's  telephone number 

**commercialName**

Recipient's  commercial name 

**stateRegistration**

Recipient's state registration 

**cityRegistration**

Recipient's municipal registration

**address**

**Recipient's Address Group Information** 

**street**

Recipient's street name

**town**

Recipient's city

**state**

Recipient's UF code 

**zipCode**

Recipient's zip code

**neighborhood**

Recipient's neighborhood

**complement**

Complement of the recipient's street address

**number**

Recipient's street number

**validSefaz**

Return of note status within SEFAZ

True - Document valid at SEFAZ, that is, it is not a canceled or denied document

False - The result of the last query reported that the key refers to a canceled or denied tax document

**hasServices**

Field to identify service note

True - The document is an NFSE

False - The document is an NFE

**operationType**

0 - Exit 

1 - Entry 

3 - Transfer

**totalInvoice**

Total invoice amount

**availableXML**

When the value is "X", tax Document has XML, 

**issueDate**

Tax document issue date 

**entryDate**

Document entry date in TaxDocs Monitor

**cancellationDate**

Tax document cancellation date

**validXmlStructure**

True - Document XML is valid

False - Document XML is structurally invalid

Null - There is no XML for the document

The API return is in JSON format as shown below:

```
{ "invoiceKey": "string", "invoiceNumber": "string", "issuer": { "cpfcnpj": "string", "businessName": "string", "phoneNumber": "string", "commercialName": "string", "stateRegistration": "string", "cityRegistration": "string", "address": { "street": "string", "town": "string", "state": "string", "zipCode": "string", "neighborhood": "string", "complement": "string", "number": "string"    }  }, "recipient": { "cpfcnpj": "string", "businessName": "string", "phoneNumber": "string", "commercialName": "string", "stateRegistration": "string", "cityRegistration": "string", "address": { "street": "string", "town": "string", "state": "string", "zipCode": "string", "neighborhood": "string", "complement": "string", "number": "string"    }  }, "validSefaz": true, "hasServices": true, "operationType": 0, "totalInvoice": 0, "availableXML": true, "issueDate": "2021-07-08T18:02:08.151Z", "entryDate": "2021-07-08T18:02:08.151Z", "cancellationDate": "2021-07-08T18:02:08.151Z", "validXmlStructure": true}
```

To retrieve the XML of the electronic invoice (NFE)

To retrieve the XML of the electronic invoice, is necessary to know the electronic key of the invoice.

URL: https://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/{invoiceKey}/XML

**invoiceKey\***

Invoice access key

**subscriptionId**

Subscription ID corresponding to the customer for which the query is made

\*Asterisk fields are required.

Below is an example of use of the endpoint /api/v1/NFE/{invoiceKey}/XML in cURL using only the required parameters:

```
curl --location --request GET 'http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/CHAVE_DA_NOTA/xml' \--header 'Authorization: Bearer SEU TOKEN'
```

Example of use of the endpoint /api/v1/NFE/{invoiceKey}/XML in C#:

```
var client = new RestClient("http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/CHAVE_DA_NOTA/xml");client.Timeout = -1;var request = new RestRequest(Method.GET);request.AddHeader("Authorization", "Bearer SEU TOKEN");var body = @"";request.AddParameter("text/plain", body,  ParameterType.RequestBody);IRestResponse response = client.Execute(request);Console.WriteLine(response.Content);
```

The expected return from the XML query contains the parameters below:

Returns a JSON with XML data in BASE64

BASE64 is a method for encoding data for transfer over the Internet, which transforms binary or text content into a format that can be decoded by the recipient, preserving the content.

Example of BASE64 content that returns:

```
"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz48bmZlUHJvYyB2ZXJzYW89IjQuMDAiIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIj48TkZlIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIj48aW5mTkZlIElkPSJORmUzMTIxMDMxNTMxNTgxNzAwMDIwNzU1MDAxMDAwMDkxOTAyMTAwOTkxOTAyNSIgdmVyc2FvPSI0LjAwIj48aWRlPjxjVUY+MzE8L2NVRj48Y05GPjAwOTkxOTAyPC9jTkY+PG5hdE9wPlZlbmRhIGRlIG1lcmNhZG9yaWEgYWRxdWlyaWRhIG91IHJlY2ViaWRhIGRlIHRlcmNlaXJvczwvbmF0T3A+PG1vZD41NTwvbW9kPjxzZXJpZT4xPC9zZXJpZT48bk5GPjkxOTAyPC9uTkY+PGRoRW1pPjIwMjEtMDMtMzFUMTY6MDU6MDAtMDM6MDA8L2RoRW1pPjxkaFNhaUVudD4yMDIxLTAzLTMxVDE2OjA1OjI1LTAzOjAwPC9kaFNhaUVudD48dHBORj4xPC90cE5GPjxpZERlc3Q+MjwvaWREZXN0PjxjTXVuRkc+MzExMDYwODwvY011bkZHPjx0cEltcD4xPC90cEltcD48dHBFbWlzPjE8L3RwRW1pcz48Y0RWPjU8L2NEVj48dHBBbWI+MTwvdHBBbWI+PGZpbk5GZT4xPC9maW5ORmU+PGluZEZpbmFsPjA8L2luZEZpbmFsPjxpbmRQcmVzPjk8L2luZFByZXM+PHByb2NFbWk+MDwvcHJvY0VtaT48dmVyUHJvYz4zLjg4LjAuMjwvdmVyUHJvYz48L2lkZT48ZW1pdD48Q05QSj4xNTMxNTgxNzAwMDIwNzwvQ05QSj48eE5vbWU+V0lOTkVSUyBCUkFTSUwgUFJPRFVUT1MgRVNQT1JUSVZPUyBMVERBPC94Tm9tZT48eEZhbnQ+V0lOTkVSUyBCUkFTSUwgUFJPRFVUT1MgRVNQT1JUSVZPUyBMVERBPC94RmFudD48ZW5kZXJFbWl0Pjx4TGdyPkF2LiBKb3NlIEZyYW5jaXNjbyBOYXNjaW1lbnRvPC94TGdyPjxucm8+MTI1PC9ucm8+PHhCYWlycm8+VmlsYSBOb3NzYSBTZW5ob3JhIEFwYXJlY2lkYTwveEJhaXJybz48Y011bj4zMTEwNjA4PC9jTXVuPjx4TXVuPkNhbWJ1aTwveE11bj48VUY+TUc8L1VGPjxDRVA+Mzc2MDAwMDA8L0NFUD48Y1BhaXM+MTA1ODwvY1BhaXM+PHhQYWlzPkJyYXNpbDwveFBhaXM+PGZvbmU+MzUzNDMxNDMwOTwvZm9uZT48L2VuZGVyRW1pdD48SUU+MDAxOTc5NzM2MDA1OTwvSUU+PElFU1Q+ODEzMDE2MzM0MTE2PC9JRVNUPjxJTT4xMjEyMjA8L0lNPjxDTkFFPjQ2ODkzOTk8L0NOQUU+PENSVD4zPC9DUlQ+PC9lbWl0PjxkZXN0PjxDTlBKPjAyMzE0MDQxMDAwMTg4PC9DTlBKPjx4Tm9tZT5JR1VBU1BPUlQgTFREQTwveE5vbWU+PGVuZGVyRGVzdD48eExncj5BVkVOSURBIEZFUk5BTkRPIENFUlFVRUlSQSBDRVNBUiBDT0lNQlJBPC94TGdyPjxucm8+NjI2PC9ucm8+PHhCYWlycm8+QUxQSEFWSUxMRSBFTVBSRVNBUklBTDwveEJhaXJybz48Y011bj4zNTA1NzA4PC9jTXVuPjx4TXVuPkJhcnVlcmk8L3hNdW4+PFVGPlNQPC9VRj48Q0VQPjA2NDY1MDkwPC9DRVA+PGNQYWlzPjEwNTg8L2NQYWlzPjx4UGFpcz5CcmFzaWw8L3hQYWlzPjxmb25lPjExMjE2NzA4Mjk8L2ZvbmU+PC9lbmRlckRlc3Q+PGluZElFRGVzdD4xPC9pbmRJRURlc3Q+PElFPjIwNjY3NzkyODExNzwvSUU+PGVtYWlsPnhtbC5maXNjYWxAZGVjYXRobG9uLmNvbTwvZW1haWw+PC9kZXN0PjxlbnRyZWdhPjxDTlBKPjAyMzE0MDQxMDAwMTg4PC9DTlBKPjx4Tm9tZT5JR1VBU1BPUlQgTFREQTwveE5vbWU+PHhMZ3I+QVZFTklEQSBGRVJOQU5ETyBDRVJRVUVJUkEgQ0VTQVIgQ09JTUJSQTwveExncj48bnJvPjYyNjwvbnJvPjx4QmFpcnJvPkFMUEhBVklMTEUgRU1QUkVTQVJJQUw8L3hCYWlycm8+PGNNdW4+MzUwNTcwODwvY011bj48eE11bj5CQVJVRVJJPC94TXVuPjxVRj5TUDwvVUY+PENFUD4wNjQ2NTA5MDwvQ0VQPjxjUGFpcz4xMDU4PC9jUGFpcz48eFBhaXM+QnJhc2lsPC94UGFpcz48Zm9uZT4xMTIxNjcwODI5PC9mb25lPjxlbWFpbD54bWwuZmlzY2FsQGRlY2F0aGxvbi5jb208L2VtYWlsPjxJRT4yMDY2Nzc5MjgxMTc8L0lFPjwvZW50cmVnYT48ZGV0IG5JdGVtPSIxIj48cHJvZD48Y1Byb2Q+V1IwNDM4MTFVMzwvY1Byb2Q+PGNFQU4+MDk3NTEyNDY0Mjg0PC9jRUFOPjx4UHJvZD5SQVEgVEVOSVMgUFJPIFNUQUZGIDk3IFYxMy4wIDM8L3hQcm9kPjxOQ00+OTUwNjUxMDA8L05DTT48Q0ZPUD42MTAyPC9DRk9QPjx1Q29tPlVOPC91Q29tPjxxQ29tPjY8L3FDb20+PHZVbkNvbT42OTEuMDEwMDAwPC92VW5Db20+PHZQcm9kPjQxNDYuMDY8L3ZQcm9kPjxjRUFOVHJpYj4wOTc1MTI0NjQyODQ8L2NFQU5UcmliPjx1VHJpYj5VTjwvdVRyaWI+PHFUcmliPjY8L3FUcmliPjx2VW5UcmliPjY5MS4wMTAwMDA8L3ZVblRyaWI+PGluZFRvdD4xPC9pbmRUb3Q+PHhQZWQ+NTUwMTExNzEwMTwveFBlZD48bkl0ZW1QZWQ+MTA8L25JdGVtUGVkPjwvcHJvZD48aW1wb3N0bz48dlRvdFRyaWI+MC4wMDwvdlRvdFRyaWI+PElDTVM+PElDTVMwMD48b3JpZz4xPC9vcmlnPjxDU1Q+MDA8L0NTVD48bW9kQkM+MzwvbW9kQkM+PHZCQz40MTQ2LjA2PC92QkM+PHBJQ01TPjQuMDA8L3BJQ01TPjx2SUNNUz4xNjUuODQ8L3ZJQ01TPjwvSUNNUzAwPjwvSUNNUz48SVBJPjxjRW5xPjk5OTwvY0VucT48SVBJVHJpYj48Q1NUPjUwPC9DU1Q+PHZCQz40MTQ2LjA2PC92QkM+PHBJUEk+MjAuMDA8L3BJUEk+PHZJUEk+ODI5LjIxPC92SVBJPjwvSVBJVHJpYj48L0lQST48UElTPjxQSVNBbGlxPjxDU1Q+MDE8L0NTVD48dkJDPjQxNDYuMDY8L3ZCQz48cFBJUz4xLjY1PC9wUElTPjx2UElTPjY4LjQxPC92UElTPjwvUElTQWxpcT48L1BJUz48Q09GSU5TPjxDT0ZJTlNBbGlxPjxDU1Q+MDE8L0NTVD48dkJDPjQxNDYuMDY8L3ZCQz48cENPRklOUz43LjYwPC9wQ09GSU5TPjx2Q09GSU5TPjMxNS4xMDwvdkNPRklOUz48L0NPRklOU0FsaXE+PC9DT0ZJTlM+PC9pbXBvc3RvPjwvZGV0Pjx0b3RhbD48SUNNU1RvdD48dkJDPjQxNDYuMDY8L3ZCQz48dklDTVM+MTY1Ljg0PC92SUNNUz48dklDTVNEZXNvbj4wLjAwPC92SUNNU0Rlc29uPjx2RkNQPjAuMDA8L3ZGQ1A+PHZCQ1NUPjAuMDA8L3ZCQ1NUPjx2U1Q+MC4wMDwvdlNUPjx2RkNQU1Q+MC4wMDwvdkZDUFNUPjx2RkNQU1RSZXQ+MC4wMDwvdkZDUFNUUmV0Pjx2UHJvZD40MTQ2LjA2PC92UHJvZD48dkZyZXRlPjAuMDA8L3ZGcmV0ZT48dlNlZz4wLjAwPC92U2VnPjx2RGVzYz4wLjAwPC92RGVzYz48dklJPjAuMDA8L3ZJST48dklQST44MjkuMjE8L3ZJUEk+PHZJUElEZXZvbD4wLjAwPC92SVBJRGV2b2w+PHZQSVM+NjguNDE8L3ZQSVM+PHZDT0ZJTlM+MzE1LjEwPC92Q09GSU5TPjx2T3V0cm8+MC4wMDwvdk91dHJvPjx2TkY+NDk3NS4yNzwvdk5GPjx2VG90VHJpYj4wLjAwPC92VG90VHJpYj48L0lDTVNUb3Q+PC90b3RhbD48dHJhbnNwPjxtb2RGcmV0ZT4wPC9tb2RGcmV0ZT48dHJhbnNwb3J0YT48Q05QSj4wOTQ5MTYzODAwMDE0NzwvQ05QSj48eE5vbWU+Uk9UQSAzODEgVFJBTlNQT1JURVMgTFREQTwveE5vbWU+PElFPjAwMTA2NzUzMzAwOTI8L0lFPjx4RW5kZXI+UlVBIFNBQklOTyBNQVJRVUVTIFBBRElMSEEgODExIFNBTlRBIEVEV0lSR0VTPC94RW5kZXI+PHhNdW4+Q2FtYnXDrTwveE11bj48VUY+TUc8L1VGPjwvdHJhbnNwb3J0YT48dm9sPjxxVm9sPjE8L3FWb2w+PGVzcD5jeDwvZXNwPjxwZXNvTD4yLjc5MDwvcGVzb0w+PHBlc29CPjMuMDcwPC9wZXNvQj48bGFjcmVzPjxuTGFjcmU+MDwvbkxhY3JlPjwvbGFjcmVzPjwvdm9sPjwvdHJhbnNwPjxjb2JyPjxmYXQ+PG5GYXQ+OTE5MDI8L25GYXQ+PHZPcmlnPjQ5NzUuMjc8L3ZPcmlnPjx2RGVzYz4wLjAwPC92RGVzYz48dkxpcT40OTc1LjI3PC92TGlxPjwvZmF0PjxkdXA+PG5EdXA+MDAxPC9uRHVwPjxkVmVuYz4yMDIxLTA2LTI5PC9kVmVuYz48dkR1cD40OTc1LjI3PC92RHVwPjwvZHVwPjwvY29icj48cGFnPjxkZXRQYWc+PHRQYWc+MTQ8L3RQYWc+PHZQYWc+NDk3NS4yNzwvdlBhZz48Y2FyZD48dHBJbnRlZ3JhPjI8L3RwSW50ZWdyYT48L2NhcmQ+PC9kZXRQYWc+PHZUcm9jbz4wLjAwPC92VHJvY28+PC9wYWc+PGluZkFkaWM+PGluZkNwbD41NTAxMTE3MTAxIFNPTElDSVRBUiBFTlRSRUdBIFBBUkEgMDYvMDQgQmFzZWFkbyBlbSBDb3Rhw6fDtWVzIGRlIHZlbmRhcyAzNTA4Mi4gQmFzZWFkbyBlbSBQZWRpZG9zIGRlIHZlbmRhIDg2MzUyLjwvaW5mQ3BsPjwvaW5mQWRpYz48aW5mUmVzcFRlYz48Q05QSj4wMDkxMDUwOTAwMDE3MTwvQ05QSj48eENvbnRhdG8+QnJ1bmEgTWljaGVsZSBCYXJib3NhPC94Q29udGF0bz48ZW1haWw+YnJ1bmEuYmFyYm9zYUB0aG9tc29ucmV1dGVycy5jb208L2VtYWlsPjxmb25lPjExOTk3NzMxNjQyPC9mb25lPjwvaW5mUmVzcFRlYz48L2luZk5GZT48U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbz48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1IiAvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiIC8+PFJlZmVyZW5jZSBVUkk9IiNORmUzMTIxMDMxNTMxNTgxNzAwMDIwNzU1MDAxMDAwMDkxOTAyMTAwOTkxOTAyNSI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIiAvPjxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz48L1RyYW5zZm9ybXM+PERpZ2VzdE1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNzaGExIiAvPjxEaWdlc3RWYWx1ZT4weGVBY2tuNHdrTys0VHBjYk9zU3lVQmNrSTg9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPkc0QjZvZmZxb1Z2eko4ZXE2bEplYThMbk14NnltaWN0VFNqSnFSWWNBa2J4OVZsc3hBdzN4NXo4YXNyMmJUrS3RucW1FSlZJeno3alhWME9lUkMwaEZZcjdIellOSEo4RnF0S2VaUnJBUkdTU2lkMTBpSHBia3ZMdHRTVjg5empKKzBaMVl6cUpSSEZtR0lYTENiVzhaVzhHaWV0TkxjM0dtWXNwSEJCa2Jjakh5V1JsdWlNbXU0LzJSN1FycmgrTGtVMU9VcXdqa0h1TmVoMGhoNFdnQ3FTSFdJMnNDWk5DbE1FWHJTdmRnV1JXNzk5eW03M1ppVmExVzJrMmtpNTFZMms3WktkMjFQUWIxRXNFbkV6SDlOb2pvUllySFlrZlRZOG5qeTJXV0VjTUhQUzd1Vm85eFdmUDh3SGJleXdoaVdRdmoxb2pKd0NxaUcxaGlrUT09PC9TaWduYXR1cmVWYWx1ZT48S2V5SW5mbz48WDUwOURhdGE+PFg1MDlDZXJ0aWZpY2F0ZT5NSUlIOGpDQ0JkcWdBd0lCQWdJSVBwdlpVMmhJUFUwd0RRWUpLb1pJaHZjTkFRRUxCUUF3ZGpFTE1Ba0dBMVVFQmhNQ1FsSXhFekFSQmdOVkJBb1RDa2xEVUMxQ2NtRnphV3d4TlRBekJnTlZCQXNUTEVGMWRHOXlhV1JoWkdVZ1EyVnlkR2xtYVdOaFpHOXlZU0JXUVV4SlJDQXRJRUZESUZaQlRFbEVJSFkxTVJzd0dRWURWUVFERXhKQlF5QldRVXhKUkNCQ1VrRlRTVXdnZGpVd0hoY05NakV3TVRJNU1USTBPVFEyV2hjTk1qSXdNVEk1TVRJME9UUTJXakNCOERFTE1Ba0dBMVVFQmhNQ1FsSXhDekFKQmdOVkJBZ1RBbE5RTVJJd0VBWURWUVFIRXdsVFFVOGdVRUZWVEU4eEV6QVJCZ05WQkFvVENrbERVQzFDY21GemFXd3hHREFXQmdOVkJBc1REMEZESUZaQlRFbEVJRUpTUVZOSlRERWJNQmtHQTFVRUN4TVNVR1Z6YzI5aElFcDFjbWxrYVdOaElFRXhNUTR3REFZRFZRUUxFd1ZXUVV4SlJERVpNQmNHQTFVRUN4TVFWbWxrWlc5amIyNW1aWEpsYm1OcFlURVhNQlVHQTFVRUN4TU9NVFF4TWpFNU5UY3dNREF4TURreE1EQXVCZ05WQkFNVEoxZEpUazVGVWxNZ1FsSkJVMGxNSUZCU1QwUlZWRTlUSUVWVFVFOVNWRWxXVDFNZ1RGUkVRVENDQVNJd0RRWUpLb1pJaHZjTkFRRUJCUUFEZ2dFUEFEQ0NBUW9DZ2dFQkFOZno4a3hVMzEraHJvS2h6emVGRVVTUDAyY2JseVN6cDJqcURtaGhNbUVaZWovb25LQ3I5NDU0M0s3WVpxUUgrTXJ1d1ZHenRaUHd1ZC8zSW01QU1IakRQVXI0MjdqYXFYVktmdmtjNEt2ZUw3dDhIbStNZGxFS2xWQWFjU2JXYlVuM1lPbHZrRXdac1U0c28vUzV2UGRiMjZEWU41RlZ2QlNLdFRVdm1QRnNEUjJYMllPZFd6azVBRXFpVzdiTUJyRTkxVGxpcEQrTGhaeTdTWHFQaXNCcEVlT1pkangxekJxQ0dPR05nenh6M2hqcy8rRnZOd3ptaXJKa1czblNBaThFOFRodEQ5Yzdja1pyU1RROHlRbkNDVDIwcXFFWFlSN3FKbDRHdzcxOWpqa0dtZVUyVXYwUUc3MlMyeDJ2cWV5UENidm5OV01VQXd0dGx6TVkzcnNDQXdFQUFhT0NBd2N3Z2dNRE1JR2lCZ2dyQmdFRkJRY0JBUVNCbFRDQmtqQmJCZ2dyQmdFRkJRY3dBb1pQYUhSMGNEb3ZMMmxqY0MxaWNtRnphV3d1ZG1Gc2FXUmpaWEowYVdacFkyRmtiM0poTG1OdmJTNWljaTloWXkxMllXeHBaR0p5WVhOcGJDOWhZeTEyWVd4cFpHSnlZWE5wYkhZMUxuQTNZakF6QmdnckJnRUZCUWN3QVlZbmFIUjBjRG92TDI5amMzQjJOUzUyWVd4cFpHTmxjblJwWm1sallXUnZjbUV1WTI5dExtSnlNQWtHQTFVZEV3UUNNQUF3SHdZRFZSMGpCQmd3Rm9BVUI5OVhveE9ZUXdoYytlSk1EaHY3SG5ndXRva3dkZ1lEVlIwZ0JHOHdiVEJyQmdaZ1RBRUNBU1F3WVRCZkJnZ3JCZ0VGQlFjQ0FSWlRhSFIwY0RvdkwybGpjQzFpY21GemFXd3VkbUZzYVdSalpYSjBhV1pwWTJGa2IzSmhMbU52YlM1aWNpOWhZeTEyWVd4cFpHSnlZWE5wYkM5a2NHTXRZV010ZG1Gc2FXUmljbUZ6YVd4Mk5TNXdaR1l3Z2NJR0ExVWRId1NCdWpDQnR6QlpvRmVnVllaVGFIUjBjRG92TDJsamNDMWljbUZ6YVd3dWRtRnNhV1JqWlhKMGFXWnBZMkZrYjNKaExtTnZiUzVpY2k5aFl5MTJZV3hwWkdKeVlYTnBiQzlzWTNJdFlXTXRkbUZzYVdSaWNtRnphV3gyTlM1amNtd3dXcUJZb0ZhR1ZHaDBkSEE2THk5cFkzQXRZbkpoYzJsc01pNTJZV3hwWkdObGNuUnBabWxqWVdSdmNtRXVZMjl0TG1KeUwyRmpMWFpoYkdsa1luSmhjMmxzTDJ4amNpMWhZeTEyWVd4cFpHSnlZWE5wYkhZMUxtTnliREFPQmdOVkhROEJBZjhFQkFNQ0JlQXdIUVlEVlIwbEJCWXdGQVlJS3dZQkJRVUhBd0lHQ0NzR0FRVUZCd01FTUlIREJnTlZIUkVFZ2Jzd2diaUJIR3B2ZVdObExuTnZkWHBoUUhkcGJtNWxjbk56Y0c5eWRDNWpiMjJnT0FZRllFd0JBd1NnTHdRdE1qQXhNakU1TnpRM01ESXhPVE0zTXpFNE16QXdNREF3TURBd01EQXdNREF3TURBd01EQXdNREF3TURBd29Db0dCV0JNQVFNQIMEZPUkZKRlV5QkJURVZLUVU1RVVrOGdRVXhhVlVkQlVrRlpJRUZUVkVXZ0dRWUZZRXdCQXdPZ0VBUU9NVFV6TVRVNE1UY3dNREF4TWphZ0Z3WUZZRXdCQXdlZ0RnUU1NREF3TURBd01EQXdNREF3TUEwR0NTcUdTSWIzRFFFQkN3VUFBNElDQVFDajN3aVhxaHlQaWh4ZjlmcjZ2aTJWYlVpMjh4NDNrRFVrQlloemJZbUJvc0hGcDRZbkUwMmVnNk84ODdYclM0dUpqdmlzNFZjdWZnYWxycSsvWmVvQW4vLy9ockgvejNObnkrbWVORmFiUWZScDFPUEJlTnU0TWRkN0Nrb245bHRtTDN1aWQ2OWZZTWExRlhQZ005ckl5elhGL2haTnlrNkwyT3hZQTZTSHliS2xEYTFwOURqbTdXbC9QOWFBTXNCQ3h0K0VkWitMbW83ZjFNWnpjZXpXQ3FuZDZSeDNKeUJyZzBSelBUT01KNVhvOU9keGhvZXFHUjZIZ1BPZHRmeklnVjFtUlA5cU55NlAyTWdvTkpWMXZuNnVkVnowejJZcDVnTTd5OUlFbkxJT0cyK1hsK0Fzam4zN3h0eEw1Q2ZXRzJpYTUxOG9LREJkSzBNZVFEQXliL3p0OXRuOHdrQXIyZDRyL0ZxQzY4MjJvUElSRmx3KytCN2cvd1BkU2w1emFkUWtWbTFLUnY5d0dtYXpHQjByc2MxYmZ6MGE3aFNjVjhkcTkvbi83TitPZ1J4bnBkY0RZVFVBdlUxZE9oUEp0NGRnV0cyY1lRekk0NE1UYVZyTzdubFVKc29QMytZdzJRZHQxZzhLeUlEYmIzQUxsZmVNZzdoOGdNR3h5YXdVTzFsSVdWaCtodXN5MWM2dkgyZ2xlMDRndk8zL25hUzdTVHdVUnp2TEhCaG9TZmxWN3NmdEs0VHF0bUdUZEo1RG5yV3B1NWFkRXM0ZUpCa1RRQUMybzRwelVoeHNIQnA1Tm9LaDBwQ001d2ZBR0lNT3VqUFF0MW1lUTZyS0s5dXhlcVc4eUYxWU14bi9pVUFqOWFleEtwRXM5T0lwRmlvZmVBUEZwd3c9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvTkZlPjxwcm90TkZlIHZlcnNhbz0iNC4wMCI+PGluZlByb3QgSWQ9IklEMTMxMjE0MDkzMTY1MDE1Ij48dHBBbWI+MTwvdHBBbWI+PHZlckFwbGljPjE0LjQuMjItTUExPC92ZXJBcGxpYz48Y2hORmU+MzEyMTAzMTUzMTU4MTcwMDAyMDc1NTAwMTAwMDA5MTkwMjEwMDk5MTkwMjU8L2NoTkZlPjxkaFJlY2J0bz4yMDIxLTAzLTMxVDE2OjA3OjEzLTAzOjAwPC9kaFJlY2J0bz48blByb3Q+MTMxMjE0MDkzMTY1MDE1PC9uUHJvdD48ZGlnVmFsPjB4ZUFja240d2tPKzRUcGNiT3NTeVVCY2tJOD08L2RpZ1ZhbD48Y1N0YXQ+MTAwPC9jU3RhdD48eE1vdGl2bz5BdXRvcml6YWRvIG8gdXNvIGRhIE5GLWU8L3hNb3Rpdm8+PC9pbmZQcm90PjwvcHJvdE5GZT48Lyb2M+"
```

To retrieve DANFE from the electronic invoice (NFE)

To retrieve DANFE (auxiliary document of the electronic invoice) in a PDF format, is necessary to know the electronic key of the invoice.

URL: https://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/{invoiceKey}/PDF

**invoiceKey\***

Invoice access key

**subscriptionId**

Subscription ID corresponding to the customer for which the query is made

\*Asterisk fields are required.

Below is an example of use of the endpoint /api/v1/NFE/{invoiceKey}/PDF in cURL using only the required parameters:

```
curl --location --request GET 'http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/CHAVE_DA_NOTA/pdf' \--header 'Authorization: Bearer SEU TOKEN'
```

Example of use of the endpoint /api/v1/NFE/{invoiceKey}/XML in C#:

```
var client = new RestClient("http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/CHAVE_DA_NOTA/pdf");client.Timeout = -1;var request = new RestRequest(Method.GET);request.AddHeader("Authorization", "Bearer SEU TOKEN");var body = @"";request.AddParameter("text/plain", body,  ParameterType.RequestBody);IRestResponse response = client.Execute(request);Console.WriteLine(response.Content);
```

The expected return of the DANFE query contains the parameters below:

Returns a JSON with XML data in BASE64

BASE64 is a method for encoding data for transfer over the Internet, which transforms binary or text content into a format that can be decoded by the recipient, preserving the content.

Example of BASE64 content that returns:

```
"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz48bmZlUHJvYyB2ZXJzYW89IjQuMDAiIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIj48TkZlIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIj48aW5mTkZlIElkPSJORmUzMTIxMDMxNTMxNTgxNzAwMDIwNzU1MDAxMDAwMDkxOTAyMTAwOTkxOTAyNSIgdmVyc2FvPSI0LjAwIj48aWRlPjxjVUY+MzE8L2NVRj48Y05GPjAwOTkxOTAyPC9jTkY+PG5hdE9wPlZlbmRhIGRlIG1lcmNhZG9yaWEgYWRxdWlyaWRhIG91IHJlY2ViaWRhIGRlIHRlcmNlaXJvczwvbmF0T3A+PG1vZD41NTwvbW9kPjxzZXJpZT4xPC9zZXJpZT48bk5GPjkxOTAyPC9uTkY+PGRoRW1pPjIwMjEtMDMtMzFUMTY6MDU6MDAtMDM6MDA8L2RoRW1pPjxkaFNhaUVudD4yMDIxLTAzLTMxVDE2OjA1OjI1LTAzOjAwPC9kaFNhaUVudD48dHBORj4xPC90cE5GPjxpZERlc3Q+MjwvaWREZXN0PjxjTXVuRkc+MzExMDYwODwvY011bkZHPjx0cEltcD4xPC90cEltcD48dHBFbWlzPjE8L3RwRW1pcz48Y0RWPjU8L2NEVj48dHBBbWI+MTwvdHBBbWI+PGZpbk5GZT4xPC9maW5ORmU+PGluZEZpbmFsPjA8L2luZEZpbmFsPjxpbmRQcmVzPjk8L2luZFByZXM+PHByb2NFbWk+MDwvcHJvY0VtaT48dmVyUHJvYz4zLjg4LjAuMjwvdmVyUHJvYz48L2lkZT48ZW1pdD48Q05QSj4xNTMxNTgxNzAwMDIwNzwvQ05QSj48eE5vbWU+V0lOTkVSUyBCUkFTSUwgUFJPRFVUT1MgRVNQT1JUSVZPUyBMVERBPC94Tm9tZT48eEZhbnQ+V0lOTkVSUyBCUkFTSUwgUFJPRFVUT1MgRVNQT1JUSVZPUyBMVERBPC94RmFudD48ZW5kZXJFbWl0Pjx4TGdyPkF2LiBKb3NlIEZyYW5jaXNjbyBOYXNjaW1lbnRvPC94TGdyPjxucm8+MTI1PC9ucm8+PHhCYWlycm8+VmlsYSBOb3NzYSBTZW5ob3JhIEFwYXJlY2lkYTwveEJhaXJybz48Y011bj4zMTEwNjA4PC9jTXVuPjx4TXVuPkNhbWJ1aTwveE11bj48VUY+TUc8L1VGPjxDRVA+Mzc2MDAwMDA8L0NFUD48Y1BhaXM+MTA1ODwvY1BhaXM+PHhQYWlzPkJyYXNpbDwveFBhaXM+PGZvbmU+MzUzNDMxNDMwOTwvZm9uZT48L2VuZGVyRW1pdD48SUU+MDAxOTc5NzM2MDA1OTwvSUU+PElFU1Q+ODEzMDE2MzM0MTE2PC9JRVNUPjxJTT4xMjEyMjA8L0lNPjxDTkFFPjQ2ODkzOTk8L0NOQUU+PENSVD4zPC9DUlQ+PC9lbWl0PjxkZXN0PjxDTlBKPjAyMzE0MDQxMDAwMTg4PC9DTlBKPjx4Tm9tZT5JR1VBU1BPUlQgTFREQTwveE5vbWU+PGVuZGVyRGVzdD48eExncj5BVkVOSURBIEZFUk5BTkRPIENFUlFVRUlSQSBDRVNBUiBDT0lNQlJBPC94TGdyPjxucm8+NjI2PC9ucm8+PHhCYWlycm8+QUxQSEFWSUxMRSBFTVBSRVNBUklBTDwveEJhaXJybz48Y011bj4zNTA1NzA4PC9jTXVuPjx4TXVuPkJhcnVlcmk8L3hNdW4+PFVGPlNQPC9VRj48Q0VQPjA2NDY1MDkwPC9DRVA+PGNQYWlzPjEwNTg8L2NQYWlzPjx4UGFpcz5CcmFzaWw8L3hQYWlzPjxmb25lPjExMjE2NzA4Mjk8L2ZvbmU+PC9lbmRlckRlc3Q+PGluZElFRGVzdD4xPC9pbmRJRURlc3Q+PElFPjIwNjY3NzkyODExNzwvSUU+PGVtYWlsPnhtbC5maXNjYWxAZGVjYXRobG9uLmNvbTwvZW1haWw+PC9kZXN0PjxlbnRyZWdhPjxDTlBKPjAyMzE0MDQxMDAwMTg4PC9DTlBKPjx4Tm9tZT5JR1VBU1BPUlQgTFREQTwveE5vbWU+PHhMZ3I+QVZFTklEQSBGRVJOQU5ETyBDRVJRVUVJUkEgQ0VTQVIgQ09JTUJSQTwveExncj48bnJvPjYyNjwvbnJvPjx4QmFpcnJvPkFMUEhBVklMTEUgRU1QUkVTQVJJQUw8L3hCYWlycm8+PGNNdW4+MzUwNTcwODwvY011bj48eE11bj5CQVJVRVJJPC94TXVuPjxVRj5TUDwvVUY+PENFUD4wNjQ2NTA5MDwvQ0VQPjxjUGFpcz4xMDU4PC9jUGFpcz48eFBhaXM+QnJhc2lsPC94UGFpcz48Zm9uZT4xMTIxNjcwODI5PC9mb25lPjxlbWFpbD54bWwuZmlzY2FsQGRlY2F0aGxvbi5jb208L2VtYWlsPjxJRT4yMDY2Nzc5MjgxMTc8L0lFPjwvZW50cmVnYT48ZGV0IG5JdGVtPSIxIj48cHJvZD48Y1Byb2Q+V1IwNDM4MTFVMzwvY1Byb2Q+PGNFQU4+MDk3NTEyNDY0Mjg0PC9jRUFOPjx4UHJvZD5SQVEgVEVOSVMgUFJPIFNUQUZGIDk3IFYxMy4wIDM8L3hQcm9kPjxOQ00+OTUwNjUxMDA8L05DTT48Q0ZPUD42MTAyPC9DRk9QPjx1Q29tPlVOPC91Q29tPjxxQ29tPjY8L3FDb20+PHZVbkNvbT42OTEuMDEwMDAwPC92VW5Db20+PHZQcm9kPjQxNDYuMDY8L3ZQcm9kPjxjRUFOVHJpYj4wOTc1MTI0NjQyODQ8L2NFQU5UcmliPjx1VHJpYj5VTjwvdVRyaWI+PHFUcmliPjY8L3FUcmliPjx2VW5UcmliPjY5MS4wMTAwMDA8L3ZVblRyaWI+PGluZFRvdD4xPC9pbmRUb3Q+PHhQZWQ+NTUwMTExNzEwMTwveFBlZD48bkl0ZW1QZWQ+MTA8L25JdGVtUGVkPjwvcHJvZD48aW1wb3N0bz48dlRvdFRyaWI+MC4wMDwvdlRvdFRyaWI+PElDTVM+PElDTVMwMD48b3JpZz4xPC9vcmlnPjxDU1Q+MDA8L0NTVD48bW9kQkM+MzwvbW9kQkM+PHZCQz40MTQ2LjA2PC92QkM+PHBJQ01TPjQuMDA8L3BJQ01TPjx2SUNNUz4xNjUuODQ8L3ZJQ01TPjwvSUNNUzAwPjwvSUNNUz48SVBJPjxjRW5xPjk5OTwvY0VucT48SVBJVHJpYj48Q1NUPjUwPC9DU1Q+PHZCQz40MTQ2LjA2PC92QkM+PHBJUEk+MjAuMDA8L3BJUEk+PHZJUEk+ODI5LjIxPC92SVBJPjwvSVBJVHJpYj48L0lQST48UElTPjxQSVNBbGlxPjxDU1Q+MDE8L0NTVD48dkJDPjQxNDYuMDY8L3ZCQz48cFBJUz4xLjY1PC9wUElTPjx2UElTPjY4LjQxPC92UElTPjwvUElTQWxpcT48L1BJUz48Q09GSU5TPjxDT0ZJTlNBbGlxPjxDU1Q+MDE8L0NTVD48dkJDPjQxNDYuMDY8L3ZCQz48cENPRklOUz43LjYwPC9wQ09GSU5TPjx2Q09GSU5TPjMxNS4xMDwvdkNPRklOUz48L0NPRklOU0FsaXE+PC9DT0ZJTlM+PC9pbXBvc3RvPjwvZGV0Pjx0b3RhbD48SUNNU1RvdD48dkJDPjQxNDYuMDY8L3ZCQz48dklDTVM+MTY1Ljg0PC92SUNNUz48dklDTVNEZXNvbj4wLjAwPC92SUNNU0Rlc29uPjx2RkNQPjAuMDA8L3ZGQ1A+PHZCQ1NUPjAuMDA8L3ZCQ1NUPjx2U1Q+MC4wMDwvdlNUPjx2RkNQU1Q+MC4wMDwvdkZDUFNUPjx2RkNQU1RSZXQ+MC4wMDwvdkZDUFNUUmV0Pjx2UHJvZD40MTQ2LjA2PC92UHJvZD48dkZyZXRlPjAuMDA8L3ZGcmV0ZT48dlNlZz4wLjAwPC92U2VnPjx2RGVzYz4wLjAwPC92RGVzYz48dklJPjAuMDA8L3ZJST48dklQST44MjkuMjE8L3ZJUEk+PHZJUElEZXZvbD4wLjAwPC92SVBJRGV2b2w+PHZQSVM+NjguNDE8L3ZQSVM+PHZDT0ZJTlM+MzE1LjEwPC92Q09GSU5TPjx2T3V0cm8+MC4wMDwvdk91dHJvPjx2TkY+NDk3NS4yNzwvdk5GPjx2VG90VHJpYj4wLjAwPC92VG90VHJpYj48L0lDTVNUb3Q+PC90b3RhbD48dHJhbnNwPjxtb2RGcmV0ZT4wPC9tb2RGcmV0ZT48dHJhbnNwb3J0YT48Q05QSj4wOTQ5MTYzODAwMDE0NzwvQ05QSj48eE5vbWU+Uk9UQSAzODEgVFJBTlNQT1JURVMgTFREQTwveE5vbWU+PElFPjAwMTA2NzUzMzAwOTI8L0lFPjx4RW5kZXI+UlVBIFNBQklOTyBNQVJRVUVTIFBBRElMSEEgODExIFNBTlRBIEVEV0lSR0VTPC94RW5kZXI+PHhNdW4+Q2FtYnXDrTwveE11bj48VUY+TUc8L1VGPjwvdHJhbnNwb3J0YT48dm9sPjxxVm9sPjE8L3FWb2w+PGVzcD5jeDwvZXNwPjxwZXNvTD4yLjc5MDwvcGVzb0w+PHBlc29CPjMuMDcwPC9wZXNvQj48bGFjcmVzPjxuTGFjcmU+MDwvbkxhY3JlPjwvbGFjcmVzPjwvdm9sPjwvdHJhbnNwPjxjb2JyPjxmYXQ+PG5GYXQ+OTE5MDI8L25GYXQ+PHZPcmlnPjQ5NzUuMjc8L3ZPcmlnPjx2RGVzYz4wLjAwPC92RGVzYz48dkxpcT40OTc1LjI3PC92TGlxPjwvZmF0PjxkdXA+PG5EdXA+MDAxPC9uRHVwPjxkVmVuYz4yMDIxLTA2LTI5PC9kVmVuYz48dkR1cD40OTc1LjI3PC92RHVwPjwvZHVwPjwvY29icj48cGFnPjxkZXRQYWc+PHRQYWc+MTQ8L3RQYWc+PHZQYWc+NDk3NS4yNzwvdlBhZz48Y2FyZD48dHBJbnRlZ3JhPjI8L3RwSW50ZWdyYT48L2NhcmQ+PC9kZXRQYWc+PHZUcm9jbz4wLjAwPC92VHJvY28+PC9wYWc+PGluZkFkaWM+PGluZkNwbD41NTAxMTE3MTAxIFNPTElDSVRBUiBFTlRSRUdBIFBBUkEgMDYvMDQgQmFzZWFkbyBlbSBDb3Rhw6fDtWVzIGRlIHZlbmRhcyAzNTA4Mi4gQmFzZWFkbyBlbSBQZWRpZG9zIGRlIHZlbmRhIDg2MzUyLjwvaW5mQ3BsPjwvaW5mQWRpYz48aW5mUmVzcFRlYz48Q05QSj4wMDkxMDUwOTAwMDE3MTwvQ05QSj48eENvbnRhdG8+QnJ1bmEgTWljaGVsZSBCYXJib3NhPC94Q29udGF0bz48ZW1haWw+YnJ1bmEuYmFyYm9zYUB0aG9tc29ucmV1dGVycy5jb208L2VtYWlsPjxmb25lPjExOTk3NzMxNjQyPC9mb25lPjwvaW5mUmVzcFRlYz48L2luZk5GZT48U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbz48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1IiAvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiIC8+PFJlZmVyZW5jZSBVUkk9IiNORmUzMTIxMDMxNTMxNTgxNzAwMDIwNzU1MDAxMDAwMDkxOTAyMTAwOTkxOTAyNSI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIiAvPjxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz48L1RyYW5zZm9ybXM+PERpZ2VzdE1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNzaGExIiAvPjxEaWdlc3RWYWx1ZT4weGVBY2tuNHdrTys0VHBjYk9zU3lVQmNrSTg9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPkc0QjZvZmZxb1Z2eko4ZXE2bEplYThMbk14NnltaWN0VFNqSnFSWWNBa2J4OVZsc3hBdzN4NXo4YXNyMmJUrS3RucW1FSlZJeno3alhWME9lUkMwaEZZcjdIellOSEo4RnF0S2VaUnJBUkdTU2lkMTBpSHBia3ZMdHRTVjg5empKKzBaMVl6cUpSSEZtR0lYTENiVzhaVzhHaWV0TkxjM0dtWXNwSEJCa2Jjakh5V1JsdWlNbXU0LzJSN1FycmgrTGtVMU9VcXdqa0h1TmVoMGhoNFdnQ3FTSFdJMnNDWk5DbE1FWHJTdmRnV1JXNzk5eW03M1ppVmExVzJrMmtpNTFZMms3WktkMjFQUWIxRXNFbkV6SDlOb2pvUllySFlrZlRZOG5qeTJXV0VjTUhQUzd1Vm85eFdmUDh3SGJleXdoaVdRdmoxb2pKd0NxaUcxaGlrUT09PC9TaWduYXR1cmVWYWx1ZT48S2V5SW5mbz48WDUwOURhdGE+PFg1MDlDZXJ0aWZpY2F0ZT5NSUlIOGpDQ0JkcWdBd0lCQWdJSVBwdlpVMmhJUFUwd0RRWUpLb1pJaHZjTkFRRUxCUUF3ZGpFTE1Ba0dBMVVFQmhNQ1FsSXhFekFSQmdOVkJBb1RDa2xEVUMxQ2NtRnphV3d4TlRBekJnTlZCQXNUTEVGMWRHOXlhV1JoWkdVZ1EyVnlkR2xtYVdOaFpHOXlZU0JXUVV4SlJDQXRJRUZESUZaQlRFbEVJSFkxTVJzd0dRWURWUVFERXhKQlF5QldRVXhKUkNCQ1VrRlRTVXdnZGpVd0hoY05NakV3TVRJNU1USTBPVFEyV2hjTk1qSXdNVEk1TVRJME9UUTJXakNCOERFTE1Ba0dBMVVFQmhNQ1FsSXhDekFKQmdOVkJBZ1RBbE5RTVJJd0VBWURWUVFIRXdsVFFVOGdVRUZWVEU4eEV6QVJCZ05WQkFvVENrbERVQzFDY21GemFXd3hHREFXQmdOVkJBc1REMEZESUZaQlRFbEVJRUpTUVZOSlRERWJNQmtHQTFVRUN4TVNVR1Z6YzI5aElFcDFjbWxrYVdOaElFRXhNUTR3REFZRFZRUUxFd1ZXUVV4SlJERVpNQmNHQTFVRUN4TVFWbWxrWlc5amIyNW1aWEpsYm1OcFlURVhNQlVHQTFVRUN4TU9NVFF4TWpFNU5UY3dNREF4TURreE1EQXVCZ05WQkFNVEoxZEpUazVGVWxNZ1FsSkJVMGxNSUZCU1QwUlZWRTlUSUVWVFVFOVNWRWxXVDFNZ1RGUkVRVENDQVNJd0RRWUpLb1pJaHZjTkFRRUJCUUFEZ2dFUEFEQ0NBUW9DZ2dFQkFOZno4a3hVMzEraHJvS2h6emVGRVVTUDAyY2JseVN6cDJqcURtaGhNbUVaZWovb25LQ3I5NDU0M0s3WVpxUUgrTXJ1d1ZHenRaUHd1ZC8zSW01QU1IakRQVXI0MjdqYXFYVktmdmtjNEt2ZUw3dDhIbStNZGxFS2xWQWFjU2JXYlVuM1lPbHZrRXdac1U0c28vUzV2UGRiMjZEWU41RlZ2QlNLdFRVdm1QRnNEUjJYMllPZFd6azVBRXFpVzdiTUJyRTkxVGxpcEQrTGhaeTdTWHFQaXNCcEVlT1pkangxekJxQ0dPR05nenh6M2hqcy8rRnZOd3ptaXJKa1czblNBaThFOFRodEQ5Yzdja1pyU1RROHlRbkNDVDIwcXFFWFlSN3FKbDRHdzcxOWpqa0dtZVUyVXYwUUc3MlMyeDJ2cWV5UENidm5OV01VQXd0dGx6TVkzcnNDQXdFQUFhT0NBd2N3Z2dNRE1JR2lCZ2dyQmdFRkJRY0JBUVNCbFRDQmtqQmJCZ2dyQmdFRkJRY3dBb1pQYUhSMGNEb3ZMMmxqY0MxaWNtRnphV3d1ZG1Gc2FXUmpaWEowYVdacFkyRmtiM0poTG1OdmJTNWljaTloWXkxMllXeHBaR0p5WVhOcGJDOWhZeTEyWVd4cFpHSnlZWE5wYkhZMUxuQTNZakF6QmdnckJnRUZCUWN3QVlZbmFIUjBjRG92TDI5amMzQjJOUzUyWVd4cFpHTmxjblJwWm1sallXUnZjbUV1WTI5dExtSnlNQWtHQTFVZEV3UUNNQUF3SHdZRFZSMGpCQmd3Rm9BVUI5OVhveE9ZUXdoYytlSk1EaHY3SG5ndXRva3dkZ1lEVlIwZ0JHOHdiVEJyQmdaZ1RBRUNBU1F3WVRCZkJnZ3JCZ0VGQlFjQ0FSWlRhSFIwY0RvdkwybGpjQzFpY21GemFXd3VkbUZzYVdSalpYSjBhV1pwWTJGa2IzSmhMbU52YlM1aWNpOWhZeTEyWVd4cFpHSnlZWE5wYkM5a2NHTXRZV010ZG1Gc2FXUmljbUZ6YVd4Mk5TNXdaR1l3Z2NJR0ExVWRId1NCdWpDQnR6QlpvRmVnVllaVGFIUjBjRG92TDJsamNDMWljbUZ6YVd3dWRtRnNhV1JqWlhKMGFXWnBZMkZrYjNKaExtTnZiUzVpY2k5aFl5MTJZV3hwWkdKeVlYTnBiQzlzWTNJdFlXTXRkbUZzYVdSaWNtRnphV3gyTlM1amNtd3dXcUJZb0ZhR1ZHaDBkSEE2THk5cFkzQXRZbkpoYzJsc01pNTJZV3hwWkdObGNuUnBabWxqWVdSdmNtRXVZMjl0TG1KeUwyRmpMWFpoYkdsa1luSmhjMmxzTDJ4amNpMWhZeTEyWVd4cFpHSnlZWE5wYkhZMUxtTnliREFPQmdOVkhROEJBZjhFQkFNQ0JlQXdIUVlEVlIwbEJCWXdGQVlJS3dZQkJRVUhBd0lHQ0NzR0FRVUZCd01FTUlIREJnTlZIUkVFZ2Jzd2diaUJIR3B2ZVdObExuTnZkWHBoUUhkcGJtNWxjbk56Y0c5eWRDNWpiMjJnT0FZRllFd0JBd1NnTHdRdE1qQXhNakU1TnpRM01ESXhPVE0zTXpFNE16QXdNREF3TURBd01EQXdNREF3TURBd01EQXdNREF3TURBd29Db0dCV0JNQVFNQIMEZPUkZKRlV5QkJURVZLUVU1RVVrOGdRVXhhVlVkQlVrRlpJRUZUVkVXZ0dRWUZZRXdCQXdPZ0VBUU9NVFV6TVRVNE1UY3dNREF4TWphZ0Z3WUZZRXdCQXdlZ0RnUU1NREF3TURBd01EQXdNREF3TUEwR0NTcUdTSWIzRFFFQkN3VUFBNElDQVFDajN3aVhxaHlQaWh4ZjlmcjZ2aTJWYlVpMjh4NDNrRFVrQlloemJZbUJvc0hGcDRZbkUwMmVnNk84ODdYclM0dUpqdmlzNFZjdWZnYWxycSsvWmVvQW4vLy9ockgvejNObnkrbWVORmFiUWZScDFPUEJlTnU0TWRkN0Nrb245bHRtTDN1aWQ2OWZZTWExRlhQZ005ckl5elhGL2haTnlrNkwyT3hZQTZTSHliS2xEYTFwOURqbTdXbC9QOWFBTXNCQ3h0K0VkWitMbW83ZjFNWnpjZXpXQ3FuZDZSeDNKeUJyZzBSelBUT01KNVhvOU9keGhvZXFHUjZIZ1BPZHRmeklnVjFtUlA5cU55NlAyTWdvTkpWMXZuNnVkVnowejJZcDVnTTd5OUlFbkxJT0cyK1hsK0Fzam4zN3h0eEw1Q2ZXRzJpYTUxOG9LREJkSzBNZVFEQXliL3p0OXRuOHdrQXIyZDRyL0ZxQzY4MjJvUElSRmx3KytCN2cvd1BkU2w1emFkUWtWbTFLUnY5d0dtYXpHQjByc2MxYmZ6MGE3aFNjVjhkcTkvbi83TitPZ1J4bnBkY0RZVFVBdlUxZE9oUEp0NGRnV0cyY1lRekk0NE1UYVZyTzdubFVKc29QMytZdzJRZHQxZzhLeUlEYmIzQUxsZmVNZzdoOGdNR3h5YXdVTzFsSVdWaCtodXN5MWM2dkgyZ2xlMDRndk8zL25hUzdTVHdVUnp2TEhCaG9TZmxWN3NmdEs0VHF0bUdUZEo1RG5yV3B1NWFkRXM0ZUpCa1RRQUMybzRwelVoeHNIQnA1Tm9LaDBwQ001d2ZBR0lNT3VqUFF0MW1lUTZyS0s5dXhlcVc4eUYxWU14bi9pVUFqOWFleEtwRXM5T0lwRmlvZmVBUEZwd3c9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvTkZlPjxwcm90TkZlIHZlcnNhbz0iNC4wMCI+PGluZlByb3QgSWQ9IklEMTMxMjE0MDkzMTY1MDE1Ij48dHBBbWI+MTwvdHBBbWI+PHZlckFwbGljPjE0LjQuMjItTUExPC92ZXJBcGxpYz48Y2hORmU+MzEyMTAzMTUzMTU4MTcwMDAyMDc1NTAwMTAwMDA5MTkwMjEwMDk5MTkwMjU8L2NoTkZlPjxkaFJlY2J0bz4yMDIxLTAzLTMxVDE2OjA3OjEzLTAzOjAwPC9kaFJlY2J0bz48blByb3Q+MTMxMjE0MDkzMTY1MDE1PC9uUHJvdD48ZGlnVmFsPjB4ZUFja240d2tPKzRUcGNiT3NTeVVCY2tJOD08L2RpZ1ZhbD48Y1N0YXQ+MTAwPC9jU3RhdD48eE1vdGl2bz5BdXRvcml6YWRvIG8gdXNvIGRhIE5GLWU8L3hNb3Rpdm8+PC9pbmZQcm90PjwvcHJvdE5GZT48Lyb2M+"
```

To consult the list of canceled invoices

For the consultation of canceled invoices, is necessary to use the mandatory parameters`startEntryDate`and`endEntryDate`. Below are other parameters for using the API.

URL: https://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFEEvent

**startEntryDate\***  

Send the invoice entry start date and time within the applicationFormat: YYYY-MM-DDT00:00:00

**endEntryDate\***

Send the invoice entry end date and time within the applicationFormat: YYYY-MM-DDT00:00:00

**$subscriptionId**

Subscription ID corresponding to the customer for which the query is made

**$top** 

Send the maximum amount of invoices that is returned by search

**$skip**

Field used to control the pagination of returns

Example: Returning 0 to 100 in the first query

From 101 to 200 on Monday, and so on until you reach the total "count"

**$filter** 

Can be used for a more specific search

Example: Search for notes of only one CNPJ, among several owned by the client

**$orderby** 

Ordering fields that come in JSON

Example 1: Sort by invoice key

Example 2: Sort by entry date

**$count**

Shows the amount of existing notes available, according to the requested return parameters

**$select**

To customize which fields return in the response

Example: invoiceKey, invoiceNumber, cnpjCpfRecipient

**$expand**

Unsupported option

**$apply**

Unsupported option

\*Asterisk fields are required.

Below is an example of use of the endpoint /api/v1/NFEEvent in cURL using only the required parameters:

```
curl --location --request GET 'http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFEEvent?startEntryDate=2021-05-01T12:59:08.714&endEntryDate=2021-05-02T12:59:08.714' \--header 'Authorization: Bearer SEU_TOKEN' \--data-raw ''
```

Example of use of the endpoint /api/v1/NFEEvent in C#:

```
var client = new RestClient("http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFEEvent?startEntryDate=2021-05-01T12:59:08.714&endEntryDate=2021-05-02T12:59:08.714");client.Timeout = -1;var request = new RestRequest(Method.GET);request.AddHeader("Authorization", "Bearer SEU TOKEN");var body = @"";request.AddParameter("text/plain", body,  ParameterType.RequestBody);IRestResponse response = client.Execute(request);Console.WriteLine(response.Content);
```

The expected return from the canceled invoice list query contains the parameters below.

You must note the`cancellationDate`field.

If there is a date, use the`invoiceKey`field to retrieve the most up-to-date information on the invoice.

You can follow the examples shown above at:

-   Retrieve the content of the electronic invoice (NFE)
-   Retrieve the XML of the electronic invoice (NFE)
-   Retrieve DANFE from the electronic invoice (NFE)

**eventCode**

Event code:

\- 210210 = knowledge

\- 210200 = confirmation

\- 210220 = unawareness

\- 210240 = non-fulfillment

**returnDate**

Return date:

Format: YYYY-MM-DDT00:00:00.000Z

**description**

Event name:

Knowledge

Unawareness

**sefaz**

true - event sent to Sefaz

false - event not sent to Sefaz

**email**

Event user email

**isCorrectionInvoice**

If it returns the value "true" it means it is a correction letter

**invoiceKey**

Invoice access key

**correctionInvoiceId**

Correction letter unique identifier (GUID)

Return example: 96a56493-43a0-4183-a2fd-f312898b23c6

**isPdfAvailable**

If it returns a "true" value it means that the correction letter PDF is available

**cancellationDate**

Data do cancelamento do documento fiscal

**eventStatus**

Status do evento

**eventJustification**

Justificativa do evento

**manifestDate**

Data do manifesto do evento

The API return is in JSON format as shown below:

```
{ "value": [    { "eventCode": "string", "returnDate": "2021-07-12T18:59:05.021Z", "description": "string", "sefaz": true, "email": "string", "isCorrectionInvoice": true, "invoiceKey": "string", "correctionInvoiceId": "string", "isPdfAvailable": true, "cancellationDate": "2021-07-12T18:59:05.021Z", "eventStatus": 0, "eventJustification": "string", "manifestDate": "2021-07-12T18:59:05.021Z"    }  ], "count": 0
```

To register the Electronic Invoice Manifest (NFE) event

To register the Electronic Invoice Manifest event, is necessary to know the electronic invoice key.

URL: https://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFE/{invoiceKey}/event

**invoiceKey**

Electronic Invoice Key

**subscriptionId**

JSON statement containing the Manifest event parameters

-   eventCode - event code:
-   210210 = knowledge
-   210200 = confirmation
-   210220 =  unawareness
-   210240 = non-fulfillment

eventReason - event description

The`event` parameter is a JSON content and must be sent as follows:

```
{ "eventCode": "string", "eventReason": "string"}
```

The return from the API is the HTTP status as below:

**HTTP code**

**Message**

200

Submission of successful manifestation

400

Bad Request - The server did not understand the request due to invalid syntax

401

Missing or Incorrect Authentication Credentials

404

Requested URL is invalid or requested resource does not exist.

To retrieve the XML of the Electronic Invoice Correction Letter (NFE)

To retrieve the XML of the electronic invoice correction letter, it is necessary to know the electronic invoice key.

URL: https://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFECorrection/{invoiceKey}/XML

**invoiceKey\***

Invoice access key

**subscriptionId**

Subscription ID corresponding to the customer for which the query is made

\*Asterisk fields are required.

Below is an example of use of the endpoint /api/v1/NFECorrection/{invoiceKey}/XML in cURL using only the required parameters:

```
curl --location --request GET 'http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFECorrectoin/CHAVE_DA_NOTA/xml' \--header 'Authorization: Bearer SEU TOKEN'
```

Example of use of the endpoint /api/v1/NFECorrection/{invoiceKey}/XML in C#:

```
var client = new RestClient("http://api-gateway.avalarabrasil.com.br/taxdocs/api/v1/NFECorrection/CHAVE_DA_NOTA/xml");client.Timeout = -1;var request = new RestRequest(Method.GET);request.AddHeader("Authorization", "Bearer SEU TOKEN");var body = @"";request.AddParameter("text/plain", body,  ParameterType.RequestBody);IRestResponse response = client.Execute(request);Console.WriteLine(response.Content);
```

The expected return of the XML query of the electronic invoice correction letter contains the parameters below:

Returns a JSON with XML data in BASE64

BASE64 is a method for encoding data for transfer over the Internet, which transforms binary or text content into a format that can be decoded by the recipient, preserving the content.

Example of BASE64 content that returns:

```
"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz48bmZlUHJvYyB2ZXJzYW89IjQuMDAiIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIj48TkZlIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIj48aW5mTkZlIElkPSJORmUzMTIxMDMxNTMxNTgxNzAwMDIwNzU1MDAxMDAwMDkxOTAyMTAwOTkxOTAyNSIgdmVyc2FvPSI0LjAwIj48aWRlPjxjVUY+MzE8L2NVRj48Y05GPjAwOTkxOTAyPC9jTkY+PG5hdE9wPlZlbmRhIGRlIG1lcmNhZG9yaWEgYWRxdWlyaWRhIG91IHJlY2ViaWRhIGRlIHRlcmNlaXJvczwvbmF0T3A+PG1vZD41NTwvbW9kPjxzZXJpZT4xPC9zZXJpZT48bk5GPjkxOTAyPC9uTkY+PGRoRW1pPjIwMjEtMDMtMzFUMTY6MDU6MDAtMDM6MDA8L2RoRW1pPjxkaFNhaUVudD4yMDIxLTAzLTMxVDE2OjA1OjI1LTAzOjAwPC9kaFNhaUVudD48dHBORj4xPC90cE5GPjxpZERlc3Q+MjwvaWREZXN0PjxjTXVuRkc+MzExMDYwODwvY011bkZHPjx0cEltcD4xPC90cEltcD48dHBFbWlzPjE8L3RwRW1pcz48Y0RWPjU8L2NEVj48dHBBbWI+MTwvdHBBbWI+PGZpbk5GZT4xPC9maW5ORmU+PGluZEZpbmFsPjA8L2luZEZpbmFsPjxpbmRQcmVzPjk8L2luZFByZXM+PHByb2NFbWk+MDwvcHJvY0VtaT48dmVyUHJvYz4zLjg4LjAuMjwvdmVyUHJvYz48L2lkZT48ZW1pdD48Q05QSj4xNTMxNTgxNzAwMDIwNzwvQ05QSj48eE5vbWU+V0lOTkVSUyBCUkFTSUwgUFJPRFVUT1MgRVNQT1JUSVZPUyBMVERBPC94Tm9tZT48eEZhbnQ+V0lOTkVSUyBCUkFTSUwgUFJPRFVUT1MgRVNQT1JUSVZPUyBMVERBPC94RmFudD48ZW5kZXJFbWl0Pjx4TGdyPkF2LiBKb3NlIEZyYW5jaXNjbyBOYXNjaW1lbnRvPC94TGdyPjxucm8+MTI1PC9ucm8+PHhCYWlycm8+VmlsYSBOb3NzYSBTZW5ob3JhIEFwYXJlY2lkYTwveEJhaXJybz48Y011bj4zMTEwNjA4PC9jTXVuPjx4TXVuPkNhbWJ1aTwveE11bj48VUY+TUc8L1VGPjxDRVA+Mzc2MDAwMDA8L0NFUD48Y1BhaXM+MTA1ODwvY1BhaXM+PHhQYWlzPkJyYXNpbDwveFBhaXM+PGZvbmU+MzUzNDMxNDMwOTwvZm9uZT48L2VuZGVyRW1pdD48SUU+MDAxOTc5NzM2MDA1OTwvSUU+PElFU1Q+ODEzMDE2MzM0MTE2PC9JRVNUPjxJTT4xMjEyMjA8L0lNPjxDTkFFPjQ2ODkzOTk8L0NOQUU+PENSVD4zPC9DUlQ+PC9lbWl0PjxkZXN0PjxDTlBKPjAyMzE0MDQxMDAwMTg4PC9DTlBKPjx4Tm9tZT5JR1VBU1BPUlQgTFREQTwveE5vbWU+PGVuZGVyRGVzdD48eExncj5BVkVOSURBIEZFUk5BTkRPIENFUlFVRUlSQSBDRVNBUiBDT0lNQlJBPC94TGdyPjxucm8+NjI2PC9ucm8+PHhCYWlycm8+QUxQSEFWSUxMRSBFTVBSRVNBUklBTDwveEJhaXJybz48Y011bj4zNTA1NzA4PC9jTXVuPjx4TXVuPkJhcnVlcmk8L3hNdW4+PFVGPlNQPC9VRj48Q0VQPjA2NDY1MDkwPC9DRVA+PGNQYWlzPjEwNTg8L2NQYWlzPjx4UGFpcz5CcmFzaWw8L3hQYWlzPjxmb25lPjExMjE2NzA4Mjk8L2ZvbmU+PC9lbmRlckRlc3Q+PGluZElFRGVzdD4xPC9pbmRJRURlc3Q+PElFPjIwNjY3NzkyODExNzwvSUU+PGVtYWlsPnhtbC5maXNjYWxAZGVjYXRobG9uLmNvbTwvZW1haWw+PC9kZXN0PjxlbnRyZWdhPjxDTlBKPjAyMzE0MDQxMDAwMTg4PC9DTlBKPjx4Tm9tZT5JR1VBU1BPUlQgTFREQTwveE5vbWU+PHhMZ3I+QVZFTklEQSBGRVJOQU5ETyBDRVJRVUVJUkEgQ0VTQVIgQ09JTUJSQTwveExncj48bnJvPjYyNjwvbnJvPjx4QmFpcnJvPkFMUEhBVklMTEUgRU1QUkVTQVJJQUw8L3hCYWlycm8+PGNNdW4+MzUwNTcwODwvY011bj48eE11bj5CQVJVRVJJPC94TXVuPjxVRj5TUDwvVUY+PENFUD4wNjQ2NTA5MDwvQ0VQPjxjUGFpcz4xMDU4PC9jUGFpcz48eFBhaXM+QnJhc2lsPC94UGFpcz48Zm9uZT4xMTIxNjcwODI5PC9mb25lPjxlbWFpbD54bWwuZmlzY2FsQGRlY2F0aGxvbi5jb208L2VtYWlsPjxJRT4yMDY2Nzc5MjgxMTc8L0lFPjwvZW50cmVnYT48ZGV0IG5JdGVtPSIxIj48cHJvZD48Y1Byb2Q+V1IwNDM4MTFVMzwvY1Byb2Q+PGNFQU4+MDk3NTEyNDY0Mjg0PC9jRUFOPjx4UHJvZD5SQVEgVEVOSVMgUFJPIFNUQUZGIDk3IFYxMy4wIDM8L3hQcm9kPjxOQ00+OTUwNjUxMDA8L05DTT48Q0ZPUD42MTAyPC9DRk9QPjx1Q29tPlVOPC91Q29tPjxxQ29tPjY8L3FDb20+PHZVbkNvbT42OTEuMDEwMDAwPC92VW5Db20+PHZQcm9kPjQxNDYuMDY8L3ZQcm9kPjxjRUFOVHJpYj4wOTc1MTI0NjQyODQ8L2NFQU5UcmliPjx1VHJpYj5VTjwvdVRyaWI+PHFUcmliPjY8L3FUcmliPjx2VW5UcmliPjY5MS4wMTAwMDA8L3ZVblRyaWI+PGluZFRvdD4xPC9pbmRUb3Q+PHhQZWQ+NTUwMTExNzEwMTwveFBlZD48bkl0ZW1QZWQ+MTA8L25JdGVtUGVkPjwvcHJvZD48aW1wb3N0bz48dlRvdFRyaWI+MC4wMDwvdlRvdFRyaWI+PElDTVM+PElDTVMwMD48b3JpZz4xPC9vcmlnPjxDU1Q+MDA8L0NTVD48bW9kQkM+MzwvbW9kQkM+PHZCQz40MTQ2LjA2PC92QkM+PHBJQ01TPjQuMDA8L3BJQ01TPjx2SUNNUz4xNjUuODQ8L3ZJQ01TPjwvSUNNUzAwPjwvSUNNUz48SVBJPjxjRW5xPjk5OTwvY0VucT48SVBJVHJpYj48Q1NUPjUwPC9DU1Q+PHZCQz40MTQ2LjA2PC92QkM+PHBJUEk+MjAuMDA8L3BJUEk+PHZJUEk+ODI5LjIxPC92SVBJPjwvSVBJVHJpYj48L0lQST48UElTPjxQSVNBbGlxPjxDU1Q+MDE8L0NTVD48dkJDPjQxNDYuMDY8L3ZCQz48cFBJUz4xLjY1PC9wUElTPjx2UElTPjY4LjQxPC92UElTPjwvUElTQWxpcT48L1BJUz48Q09GSU5TPjxDT0ZJTlNBbGlxPjxDU1Q+MDE8L0NTVD48dkJDPjQxNDYuMDY8L3ZCQz48cENPRklOUz43LjYwPC9wQ09GSU5TPjx2Q09GSU5TPjMxNS4xMDwvdkNPRklOUz48L0NPRklOU0FsaXE+PC9DT0ZJTlM+PC9pbXBvc3RvPjwvZGV0Pjx0b3RhbD48SUNNU1RvdD48dkJDPjQxNDYuMDY8L3ZCQz48dklDTVM+MTY1Ljg0PC92SUNNUz48dklDTVNEZXNvbj4wLjAwPC92SUNNU0Rlc29uPjx2RkNQPjAuMDA8L3ZGQ1A+PHZCQ1NUPjAuMDA8L3ZCQ1NUPjx2U1Q+MC4wMDwvdlNUPjx2RkNQU1Q+MC4wMDwvdkZDUFNUPjx2RkNQU1RSZXQ+MC4wMDwvdkZDUFNUUmV0Pjx2UHJvZD40MTQ2LjA2PC92UHJvZD48dkZyZXRlPjAuMDA8L3ZGcmV0ZT48dlNlZz4wLjAwPC92U2VnPjx2RGVzYz4wLjAwPC92RGVzYz48dklJPjAuMDA8L3ZJST48dklQST44MjkuMjE8L3ZJUEk+PHZJUElEZXZvbD4wLjAwPC92SVBJRGV2b2w+PHZQSVM+NjguNDE8L3ZQSVM+PHZDT0ZJTlM+MzE1LjEwPC92Q09GSU5TPjx2T3V0cm8+MC4wMDwvdk91dHJvPjx2TkY+NDk3NS4yNzwvdk5GPjx2VG90VHJpYj4wLjAwPC92VG90VHJpYj48L0lDTVNUb3Q+PC90b3RhbD48dHJhbnNwPjxtb2RGcmV0ZT4wPC9tb2RGcmV0ZT48dHJhbnNwb3J0YT48Q05QSj4wOTQ5MTYzODAwMDE0NzwvQ05QSj48eE5vbWU+Uk9UQSAzODEgVFJBTlNQT1JURVMgTFREQTwveE5vbWU+PElFPjAwMTA2NzUzMzAwOTI8L0lFPjx4RW5kZXI+UlVBIFNBQklOTyBNQVJRVUVTIFBBRElMSEEgODExIFNBTlRBIEVEV0lSR0VTPC94RW5kZXI+PHhNdW4+Q2FtYnXDrTwveE11bj48VUY+TUc8L1VGPjwvdHJhbnNwb3J0YT48dm9sPjxxVm9sPjE8L3FWb2w+PGVzcD5jeDwvZXNwPjxwZXNvTD4yLjc5MDwvcGVzb0w+PHBlc29CPjMuMDcwPC9wZXNvQj48bGFjcmVzPjxuTGFjcmU+MDwvbkxhY3JlPjwvbGFjcmVzPjwvdm9sPjwvdHJhbnNwPjxjb2JyPjxmYXQ+PG5GYXQ+OTE5MDI8L25GYXQ+PHZPcmlnPjQ5NzUuMjc8L3ZPcmlnPjx2RGVzYz4wLjAwPC92RGVzYz48dkxpcT40OTc1LjI3PC92TGlxPjwvZmF0PjxkdXA+PG5EdXA+MDAxPC9uRHVwPjxkVmVuYz4yMDIxLTA2LTI5PC9kVmVuYz48dkR1cD40OTc1LjI3PC92RHVwPjwvZHVwPjwvY29icj48cGFnPjxkZXRQYWc+PHRQYWc+MTQ8L3RQYWc+PHZQYWc+NDk3NS4yNzwvdlBhZz48Y2FyZD48dHBJbnRlZ3JhPjI8L3RwSW50ZWdyYT48L2NhcmQ+PC9kZXRQYWc+PHZUcm9jbz4wLjAwPC92VHJvY28+PC9wYWc+PGluZkFkaWM+PGluZkNwbD41NTAxMTE3MTAxIFNPTElDSVRBUiBFTlRSRUdBIFBBUkEgMDYvMDQgQmFzZWFkbyBlbSBDb3Rhw6fDtWVzIGRlIHZlbmRhcyAzNTA4Mi4gQmFzZWFkbyBlbSBQZWRpZG9zIGRlIHZlbmRhIDg2MzUyLjwvaW5mQ3BsPjwvaW5mQWRpYz48aW5mUmVzcFRlYz48Q05QSj4wMDkxMDUwOTAwMDE3MTwvQ05QSj48eENvbnRhdG8+QnJ1bmEgTWljaGVsZSBCYXJib3NhPC94Q29udGF0bz48ZW1haWw+YnJ1bmEuYmFyYm9zYUB0aG9tc29ucmV1dGVycy5jb208L2VtYWlsPjxmb25lPjExOTk3NzMxNjQyPC9mb25lPjwvaW5mUmVzcFRlYz48L2luZk5GZT48U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbz48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1IiAvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiIC8+PFJlZmVyZW5jZSBVUkk9IiNORmUzMTIxMDMxNTMxNTgxNzAwMDIwNzU1MDAxMDAwMDkxOTAyMTAwOTkxOTAyNSI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIiAvPjxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz48L1RyYW5zZm9ybXM+PERpZ2VzdE1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNzaGExIiAvPjxEaWdlc3RWYWx1ZT4weGVBY2tuNHdrTys0VHBjYk9zU3lVQmNrSTg9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPkc0QjZvZmZxb1Z2eko4ZXE2bEplYThMbk14NnltaWN0VFNqSnFSWWNBa2J4OVZsc3hBdzN4NXo4YXNyMmJUrS3RucW1FSlZJeno3alhWME9lUkMwaEZZcjdIellOSEo4RnF0S2VaUnJBUkdTU2lkMTBpSHBia3ZMdHRTVjg5empKKzBaMVl6cUpSSEZtR0lYTENiVzhaVzhHaWV0TkxjM0dtWXNwSEJCa2Jjakh5V1JsdWlNbXU0LzJSN1FycmgrTGtVMU9VcXdqa0h1TmVoMGhoNFdnQ3FTSFdJMnNDWk5DbE1FWHJTdmRnV1JXNzk5eW03M1ppVmExVzJrMmtpNTFZMms3WktkMjFQUWIxRXNFbkV6SDlOb2pvUllySFlrZlRZOG5qeTJXV0VjTUhQUzd1Vm85eFdmUDh3SGJleXdoaVdRdmoxb2pKd0NxaUcxaGlrUT09PC9TaWduYXR1cmVWYWx1ZT48S2V5SW5mbz48WDUwOURhdGE+PFg1MDlDZXJ0aWZpY2F0ZT5NSUlIOGpDQ0JkcWdBd0lCQWdJSVBwdlpVMmhJUFUwd0RRWUpLb1pJaHZjTkFRRUxCUUF3ZGpFTE1Ba0dBMVVFQmhNQ1FsSXhFekFSQmdOVkJBb1RDa2xEVUMxQ2NtRnphV3d4TlRBekJnTlZCQXNUTEVGMWRHOXlhV1JoWkdVZ1EyVnlkR2xtYVdOaFpHOXlZU0JXUVV4SlJDQXRJRUZESUZaQlRFbEVJSFkxTVJzd0dRWURWUVFERXhKQlF5QldRVXhKUkNCQ1VrRlRTVXdnZGpVd0hoY05NakV3TVRJNU1USTBPVFEyV2hjTk1qSXdNVEk1TVRJME9UUTJXakNCOERFTE1Ba0dBMVVFQmhNQ1FsSXhDekFKQmdOVkJBZ1RBbE5RTVJJd0VBWURWUVFIRXdsVFFVOGdVRUZWVEU4eEV6QVJCZ05WQkFvVENrbERVQzFDY21GemFXd3hHREFXQmdOVkJBc1REMEZESUZaQlRFbEVJRUpTUVZOSlRERWJNQmtHQTFVRUN4TVNVR1Z6YzI5aElFcDFjbWxrYVdOaElFRXhNUTR3REFZRFZRUUxFd1ZXUVV4SlJERVpNQmNHQTFVRUN4TVFWbWxrWlc5amIyNW1aWEpsYm1OcFlURVhNQlVHQTFVRUN4TU9NVFF4TWpFNU5UY3dNREF4TURreE1EQXVCZ05WQkFNVEoxZEpUazVGVWxNZ1FsSkJVMGxNSUZCU1QwUlZWRTlUSUVWVFVFOVNWRWxXVDFNZ1RGUkVRVENDQVNJd0RRWUpLb1pJaHZjTkFRRUJCUUFEZ2dFUEFEQ0NBUW9DZ2dFQkFOZno4a3hVMzEraHJvS2h6emVGRVVTUDAyY2JseVN6cDJqcURtaGhNbUVaZWovb25LQ3I5NDU0M0s3WVpxUUgrTXJ1d1ZHenRaUHd1ZC8zSW01QU1IakRQVXI0MjdqYXFYVktmdmtjNEt2ZUw3dDhIbStNZGxFS2xWQWFjU2JXYlVuM1lPbHZrRXdac1U0c28vUzV2UGRiMjZEWU41RlZ2QlNLdFRVdm1QRnNEUjJYMllPZFd6azVBRXFpVzdiTUJyRTkxVGxpcEQrTGhaeTdTWHFQaXNCcEVlT1pkangxekJxQ0dPR05nenh6M2hqcy8rRnZOd3ptaXJKa1czblNBaThFOFRodEQ5Yzdja1pyU1RROHlRbkNDVDIwcXFFWFlSN3FKbDRHdzcxOWpqa0dtZVUyVXYwUUc3MlMyeDJ2cWV5UENidm5OV01VQXd0dGx6TVkzcnNDQXdFQUFhT0NBd2N3Z2dNRE1JR2lCZ2dyQmdFRkJRY0JBUVNCbFRDQmtqQmJCZ2dyQmdFRkJRY3dBb1pQYUhSMGNEb3ZMMmxqY0MxaWNtRnphV3d1ZG1Gc2FXUmpaWEowYVdacFkyRmtiM0poTG1OdmJTNWljaTloWXkxMllXeHBaR0p5WVhOcGJDOWhZeTEyWVd4cFpHSnlZWE5wYkhZMUxuQTNZakF6QmdnckJnRUZCUWN3QVlZbmFIUjBjRG92TDI5amMzQjJOUzUyWVd4cFpHTmxjblJwWm1sallXUnZjbUV1WTI5dExtSnlNQWtHQTFVZEV3UUNNQUF3SHdZRFZSMGpCQmd3Rm9BVUI5OVhveE9ZUXdoYytlSk1EaHY3SG5ndXRva3dkZ1lEVlIwZ0JHOHdiVEJyQmdaZ1RBRUNBU1F3WVRCZkJnZ3JCZ0VGQlFjQ0FSWlRhSFIwY0RvdkwybGpjQzFpY21GemFXd3VkbUZzYVdSalpYSjBhV1pwWTJGa2IzSmhMbU52YlM1aWNpOWhZeTEyWVd4cFpHSnlZWE5wYkM5a2NHTXRZV010ZG1Gc2FXUmljbUZ6YVd4Mk5TNXdaR1l3Z2NJR0ExVWRId1NCdWpDQnR6QlpvRmVnVllaVGFIUjBjRG92TDJsamNDMWljbUZ6YVd3dWRtRnNhV1JqWlhKMGFXWnBZMkZrYjNKaExtTnZiUzVpY2k5aFl5MTJZV3hwWkdKeVlYTnBiQzlzWTNJdFlXTXRkbUZzYVdSaWNtRnphV3gyTlM1amNtd3dXcUJZb0ZhR1ZHaDBkSEE2THk5cFkzQXRZbkpoYzJsc01pNTJZV3hwWkdObGNuUnBabWxqWVdSdmNtRXVZMjl0TG1KeUwyRmpMWFpoYkdsa1luSmhjMmxzTDJ4amNpMWhZeTEyWVd4cFpHSnlZWE5wYkhZMUxtTnliREFPQmdOVkhROEJBZjhFQkFNQ0JlQXdIUVlEVlIwbEJCWXdGQVlJS3dZQkJRVUhBd0lHQ0NzR0FRVUZCd01FTUlIREJnTlZIUkVFZ2Jzd2diaUJIR3B2ZVdObExuTnZkWHBoUUhkcGJtNWxjbk56Y0c5eWRDNWpiMjJnT0FZRllFd0JBd1NnTHdRdE1qQXhNakU1TnpRM01ESXhPVE0zTXpFNE16QXdNREF3TURBd01EQXdNREF3TURBd01EQXdNREF3TURBd29Db0dCV0JNQVFNQIMEZPUkZKRlV5QkJURVZLUVU1RVVrOGdRVXhhVlVkQlVrRlpJRUZUVkVXZ0dRWUZZRXdCQXdPZ0VBUU9NVFV6TVRVNE1UY3dNREF4TWphZ0Z3WUZZRXdCQXdlZ0RnUU1NREF3TURBd01EQXdNREF3TUEwR0NTcUdTSWIzRFFFQkN3VUFBNElDQVFDajN3aVhxaHlQaWh4ZjlmcjZ2aTJWYlVpMjh4NDNrRFVrQlloemJZbUJvc0hGcDRZbkUwMmVnNk84ODdYclM0dUpqdmlzNFZjdWZnYWxycSsvWmVvQW4vLy9ockgvejNObnkrbWVORmFiUWZScDFPUEJlTnU0TWRkN0Nrb245bHRtTDN1aWQ2OWZZTWExRlhQZ005ckl5elhGL2haTnlrNkwyT3hZQTZTSHliS2xEYTFwOURqbTdXbC9QOWFBTXNCQ3h0K0VkWitMbW83ZjFNWnpjZXpXQ3FuZDZSeDNKeUJyZzBSelBUT01KNVhvOU9keGhvZXFHUjZIZ1BPZHRmeklnVjFtUlA5cU55NlAyTWdvTkpWMXZuNnVkVnowejJZcDVnTTd5OUlFbkxJT0cyK1hsK0Fzam4zN3h0eEw1Q2ZXRzJpYTUxOG9LREJkSzBNZVFEQXliL3p0OXRuOHdrQXIyZDRyL0ZxQzY4MjJvUElSRmx3KytCN2cvd1BkU2w1emFkUWtWbTFLUnY5d0dtYXpHQjByc2MxYmZ6MGE3aFNjVjhkcTkvbi83TitPZ1J4bnBkY0RZVFVBdlUxZE9oUEp0NGRnV0cyY1lRekk0NE1UYVZyTzdubFVKc29QMytZdzJRZHQxZzhLeUlEYmIzQUxsZmVNZzdoOGdNR3h5YXdVTzFsSVdWaCtodXN5MWM2dkgyZ2xlMDRndk8zL25hUzdTVHdVUnp2TEhCaG9TZmxWN3NmdEs0VHF0bUdUZEo1RG5yV3B1NWFkRXM0ZUpCa1RRQUMybzRwelVoeHNIQnA1Tm9LaDBwQ001d2ZBR0lNT3VqUFF0MW1lUTZyS0s5dXhlcVc4eUYxWU14bi9pVUFqOWFleEtwRXM5T0lwRmlvZmVBUEZwd3c9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvTkZlPjxwcm90TkZlIHZlcnNhbz0iNC4wMCI+PGluZlByb3QgSWQ9IklEMTMxMjE0MDkzMTY1MDE1Ij48dHBBbWI+MTwvdHBBbWI+PHZlckFwbGljPjE0LjQuMjItTUExPC92ZXJBcGxpYz48Y2hORmU+MzEyMTAzMTUzMTU4MTcwMDAyMDc1NTAwMTAwMDA5MTkwMjEwMDk5MTkwMjU8L2NoTkZlPjxkaFJlY2J0bz4yMDIxLTAzLTMxVDE2OjA3OjEzLTAzOjAwPC9kaFJlY2J0bz48blByb3Q+MTMxMjE0MDkzMTY1MDE1PC9uUHJvdD48ZGlnVmFsPjB4ZUFja240d2tPKzRUcGNiT3NTeVVCY2tJOD08L2RpZ1ZhbD48Y1N0YXQ+MTAwPC9jU3RhdD48eE1vdGl2bz5BdXRvcml6YWRvIG8gdXNvIGRhIE5GLWU8L3hNb3Rpdm8+PC9pbmZQcm90PjwvcHJvdE5GZT48Lyb2M+"
```

[Previous](/tax-docs-en/user_experience/design_experience)

[Next](/tax-docs-en/transactions/bill_of_lading)