# Obter XML

## Endpoint

<mark style="color:green;">`POST`</mark> [`https://sandbox-api.invoisys.com.br/api/nfe/obterxml`](https://sandbox-api.invoisys.com.br/api/nfe/obterxml)

**Headers**

<table><thead><tr><th width="269">Name</th><th>Type</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td>string</td><td><code>application/json</code></td></tr><tr><td>Accept</td><td>string</td><td><code>application/jso​n</code></td></tr><tr><td>Authorization</td><td>string</td><td><code>Bearer &#x3C;token></code></td></tr></tbody></table>

**Body**

| Name             | Type    | Description                                                      |
| ---------------- | ------- | ---------------------------------------------------------------- |
| `ambiente`       | integer | <p>Ambiente da requisição<br>1 - Produção<br>2 - Homologação</p> |
| `cnpj`           | string  | CNPJ da empresa emitente                                         |
| `serie`          | integer | Série da NF-e emitida                                            |
| `numero`         | integer | Número da NF-e emitida                                           |
| `chaveDeAcesso`  | string  | Chave de Acesso da NF-e emitida                                  |
| `tipoRetornoXML` | integer | <p>Tipo de retorno do XML<br>0 - String do XML<br>1 - Base64</p> |

**Response**

{% tabs %}
{% tab title="200 - Retorno em string XML" %}
{% code fullWidth="true" %}

```json
{
  "xml": "<nfeProc xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\"><NFe><infNFe versao=\"4.00\" Id=\"NFe43240917921427000125558820000006821324105157\"><ide><cUF>43</cUF><cNF>22470715</cNF><natOp>Entrada de mercadoria ou bem recebido p/ conserto ou reparo</natOp><mod>55</mod><serie>882</serie><nNF>681</nNF><dhEmi>2024-09-03T17:18:53-03:00</dhEmi><tpNF>1</tpNF><idDest>1</idDest><cMunFG>4314902</cMunFG><tpImp>1</tpImp><tpEmis>1</tpEmis><cDV>0</cDV><tpAmb>2</tpAmb><finNFe>1</finNFe><indFinal>1</indFinal><indPres>1</indPres><procEmi>0</procEmi><verProc>1.0.0</verProc></ide><emit><CNPJ>17921427000125</CNPJ><xNome>INVOISYS SISTEMAS LTDA HML</xNome><xFant>INVOISYS SISTEMAS LTDA RFB</xFant><enderEmit>....",
  "xmlCancelamento": ""
}
```

{% endcode %}
{% endtab %}

{% tab title="200 - Retorno em base64" %}

```json
{
  "xml": "PG5mZVByb2MgeG1sbnM9Imh0dHA6Ly93d3cucG9ydGFsZmlzY2FsLmluZi5ici9uZmUiC9tb2Q+PHNlcmllPjg4Mjwvc2VyaWU+PG5ORj42ODE8L25ORj48ZGhFbWk+MjAyNC0wOS0wM1QxNzoxODo1My0wMzowMDwvZGhFbWk+PHRwTkY+MTwvdHBORj48aWREZXN0PjE8L2lkRGVzdD48Y011bkZHPjQzMTQ5MDI8L2NNdW5GRz48dHBJbXA+MTwvdHBJbXA+PHRwRW1pcz4xPC90cEVtaXM+PGNEVj4wPC9jRFY+PHRwQW1iPjI8L3RwQW1iPjxmaW5ORmU+MTwvZmluTkZlPjxpbmRGaW5hbD4xPC9pbmRGaW5hbD48aW5kUHJlcz4xPC9pbmRQcmVzPjxwcm9jRW1pPjA8L3Byb2NFbWk+PHZlclByb2M+MS4wLjA8L3ZlclByb2M+PC9pZGU+PGVtaXQ+PENOUEo+MTc5MjE0MjcwMDAxMjU8L0NOUEo+PHhOb21lPklOVk9JU1lTIFNJU1RFTUFTIExUREEgSE1MPC94Tm9tZT48eEZhbnQ+SU5WT0lTWVMgU0lTVEVNQVMgTFREQSBSRkI8L3hGYW50PjxlbmRlckVtaXQ+PHhMZ3I+UiBEQVMgUFJJTUFWRVJBUzwveExncj48bnJvPjEzMzwvbnJvPjx4Q3BsPlRFU1RFIENPTVBMRU1FTlRPPC94Q3BsPjx4QmFpcnJvPktvYnJhc29sPC94QmFpcnJvPjxjTXVuPjQzMTQ5MDI8L2NNdW4+PHhNdW4+UE9SVE8gQUxFR1JFPC94TXVuPjxVRj5SUzwvVUY+PENFUD44ODEwMTExMDwvQ0VQPjxjUGFpcz4xMDU4PC9jUGFpcz48eFBhaXM+QlJBU0lMPC94UGFpcz48Zm9uZT4xMTU1MDUxNzg4PC9mb25lPjwvZW5kZXJFbWl0PjxJRT4xODAwMTM2MDwvSUU+PENSVD4zPC9DUlQ+PC9lbWl0PjxkZXN0PjxDTlBKPjMzODU2Mzk0MDAxMzc3PC9DTlBKPjx4Tm9tZT5ORi1FIEVNSVRJREEgRU0gQU1CSUVOVEUgREUgSE9NT0xPR0FDQU8gLSBTRU0gVkFMT1IgRklTQ0FMPC94Tm9tZT48ZW5kZXJEZXN0Pjx4TGdyPlJ1YSBCZW50byBTaWx2w6lyaW88L3hMZ3I+PG5ybz4zODwvbnJvPjx4QmFpcnJvPlZJTEEgQ09SREVJUk88L3hCYWlycm8+PGNNdW4+MzU1MDMwODwvY011bj48eE11bj5TQU8gUEFVTE88L3hNdW4+PFVGPlNQPC9VRj48Q0VQPjA0NTgzOTA0PC9DRVA+PC9lbmRlckRlc3Q+PGluZElFRGVzdD4yPC9pbmRJRURlc3Q+PC9kZXN0PjxkZXQgbkl0ZW09IjEiPjxwcm9kPjxjUHJvZD4zNjwvY1Byb2Q+PGNFQU4+U0VNIEdUSU48L2NFQU4+PHhQcm9kPklQSE9ORSA4IEdTTSA2NEdCIFNQQUNFIEdSQVk8L3hQcm9kPjxOQ00+ODUxNzYxOTE8L05DTT48Q0VTVD4yMTExMDAwPC9DRVNUPjxDRk9QPjU0MDU8L0NGT1A+PHVDb20+UEM8L3VDb20+PHFDb20+MS4wMDAwPC9xQ29tPjx2VW5Db20+NDAwMDAuMDAwMDAwMDAwMDwvdlVuQ29tPjx2UHJvZD40MDAwMC4wMDwvdlByb2Q+PGNFQU5UcmliPlNFTSBHVElOPC9jRUFOVHJpYj48dVRyaWI+UEM8L3VUcmliPjxxVHJpYj4xLjAwMDA8L3FUcmliPjx2VW5UcmliPjQwMDAwLjAwMDAwMDAwMDA8L3ZVblRyaWI+PGluZFRvdD4xPC9pbmRUb3Q+PC9wcm9kPjxpbXBvc3RvPjxJQ01TPjxJQ01TNjA+PG9yaWc+MDwvb3JpZz48Q1NUPjYwPC9DU1Q+PHZCQ1NUUmV0PjEyMzQ1Njc4OTEyMzQuMTI8L3ZCQ1NUUmV0PjxwU1Q+MTIzLjEzMDA8L3BTVD48dklDTVNTdWJzdGl0dXRvPjEyMzQ1Njc4OTEyMzQuMTI8L3ZJQ01TU3Vic3RpdHV0bz48dklDTVNTVFJldD4xMjM0NTY3ODkxMjM0LjEyPC92SUNNU1NUUmV0Pjx2QkNGQ1BTVFJldD4xMjM0NTY3ODkxMjM0LjEyPC92QkNGQ1BTVFJldD48cEZDUFNUUmV0PjEyMy4xMzAwPC9wRkNQU1RSZXQ+PHZGQ1BTVFJldD4xMjM0NTY3ODkxMjM0LjEyPC92RkNQU1RSZXQ+PHBSZWRCQ0VmZXQ+MTIzLjEzMDA8L3BSZWRCQ0VmZXQ+PHZCQ0VmZXQ+MTIzNDU2Nzg5MTIzNC4xMjwvdkJDRWZldD48cElDTVNFZmV0PjEyMy4xMzAwPC9wSUNNU0VmZXQ+PHZJQ01TRWZldD4xMjM0NTY3ODkxMjM0LjEyPC92SUNNU0VmZXQ+PC9JQ01TNjA+PC9JQ01TPjxQSVM+PFBJU05UPjxDU1Q+MDc8L0NTVD48L1BJU05UPjwvUElTPjxDT0ZJTlM+PENPRklOU05UPjxDU1Q+MDc8L0NTVD48L0NPRklOU05UPjwvQ09GSU5TPjwvaW1wb3N0bz48L2RldD48dG90YWw+PElDTVNUb3Q+PHZCQz4wLjAwPC92QkM+PHZJQ01TPjAuMDA8L3ZJQ01TPjx2SUNNU0Rlc29uPjAuMDA8L3ZJQ01TRGVzb24+PHZGQ1A+MC4wMDwvdkZDUD48dkJDU1Q+MC4wMDwvdkJDU1Q+PHZTVD4wLjAwPC92U1Q+PHZGQ1BTVD4wLjAwPC92RkNQU1Q+PHZGQ1BTVFJldD4xMjM0NTY3ODkxMjM0LjEyPC92RkNQU1RSZXQ+PHZQcm9kPjQwMDAwLjAwPC92UHJvZD48dkZyZXRlPjAuMDA8L3ZGcmV0ZT48dlNlZz4wLjAwPC92U2VnPjx2RGVzYz4wLjAwPC92RGVzYz48dklJPjAuMDA8L3ZJST48dklQST4wLjAwPC92SVBJPjx2SVBJRGV2b2w+MC4wMDwvdklQSURldm9sPjx2UElTPjAuMDA8L3ZQSVM+PHZDT0ZJTlM+MC4wMDwvdkNPRklOUz48dk91dHJvPjAuMDA8L3ZPdXRybz48dk5GPjQwMDAwLjAwPC92TkY+PC9JQ01TVG90PjwvdG90YWw+PHRyYW5zcD48bW9kRnJldGU+OTwvbW9kRnJldGU+PC90cmFuc3A+PHBhZz48ZGV0UGFnPjx0UGFnPjkwPC90UGFnPjx2UGFnPjAuMDA8L3ZQYWc+PC9kZXRQYWc+PC9wYWc+PGluZkFkaWM+PGluZkNwbD5UZXN0ZSBjb20gbyBkZWxpbWl0YWRvciBPUzogT1M0NTY3OCBURVNURTwvaW5mQ3BsPjwvaW5mQWRpYz48L2luZk5GZT48U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd...",
  "xmlCancelamento": ""
}
```

{% endtab %}

{% tab title="400 - NF-e inexistente" %}

```
"Nenhuma NF-e encontrada"
```

{% endtab %}
{% endtabs %}

## Modelo de Envio 📝

```javascript
{
  "ambiente": 1,
  "cnpj": "string",
  "serie": 0,
  "numero": 0,
  "chaveDeAcesso": "string",
  "tipoRetornoXML": 0
}
```

{% hint style="info" %}

#### Swagger

[Você pode acessar nossa API e realizar testes diretamente na nossa plataforma Swagger!](https://sandbox-api.invoisys.com.br/swagger/ui/index#/)
{% endhint %}

## Referências à API 📌

* [Passo-a-Passo da NF-e](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/emissao/nf-e/integracao-passo-a-passo)
* [Fluxograma - Envio Normal](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/emissao/nf-e/teste-fluxos-operacionais/envio-normal-modelo-completo)
* [Fluxograma - Envio Contingência](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/emissao/nf-e/teste-fluxos-operacionais/envio-contingencia-modelo-completo)
* [Fluxograma - Cancelamento](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/emissao/nf-e/teste-fluxos-operacionais/cancelamento-modelo-completo)