Obter XML

Responsável por fornecer ao integrador o XML em formato string ou base64 de uma NF-e, utilizando o conjunto CNPJ do emitente, número e série da nota ou sua chave de acesso.

Endpoint

POST https://sandbox-api.invoisys.com.br/api/nfe/obterxml

Headers

Name	Type	Value
Content-Type	string	application/json
Accept	string	application/jso​n
Authorization	string	Bearer <token>

Body

Name	Type	Description
ambiente	integer	Ambiente da requisição 1 - Produção 2 - Homologação
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	Tipo de retorno do XML 0 - String do XML 1 - Base64

Response

200 - Retorno em string XML

{
  "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": ""
}

200 - Retorno em base64

{
  "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": ""
}

400 - NF-e inexistente

"Nenhuma NF-e encontrada"

Modelo de Envio 📝

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

Swagger

Você pode acessar nossa API e realizar testes diretamente na nossa plataforma Swagger!

Referências à API 📌

• Passo-a-Passo da NF-e
• Fluxograma - Envio Normal
• Fluxograma - Envio Contingência
• Fluxograma - Cancelamento