Como emitir um DFe?
Na API REST Oobj você não precisa chamar um endpoint diferente para cada tipo de Documento Fiscal Eletrônico (DFe).
Para solicitar a emissão de qualquer tipo de DFe você irá fazer uma requisição POST ao endpoint Emitir DFe, enviando o código do modelo de documento como parâmetro. Confira os detalhes abaixo 😉
Envie uma requisição de emissão para a Sefaz
- Para começar, faça uma requisição tipo POST ao endpoint emitir DFe;
[URL_BASE]/api/empresas/{empresa}/docs/{ambiente}/{codModelo}
Preencha as seguintes informações (
path parameters):{empresa}*: CNPJ da Empresa;{ambiente}*: hom ou prod;{codModelo}*: 55 (NFe), 57 (CTe), 58 (MDFe), 65 (NFCe), 66 (NF3e) ou 99 (NFSe);{layoutDFe}: oobj (XML Oobj), sefaz (XML Sefaz), txtsp, txt abrasf, json-oobj ou xmldatasul;
O parâmetro {layoutDFe} NÃO é obrigatório e seu valor padrão é XML Oobj. Então, caso o layout não seja informado, a API assume que o DFe está no layout Oobj.
No corpo da requisição (
request body), preencha com o conteúdo do DFe;Informe o x-auth-token no cabeçalho (
header parameters) da requisição.
Exemplo de requisição
O exemplo abaixo traz um modelo de requisição preenchido para emissão de NFe.
O XML contém dados fictícios, somente para demonstração.
curl -L -X POST 'https://rest-teste.oobj.com.br/api/empresas/07385111000102/docs/prod/55' \
-H 'Content-Type: application/xml' \
-H 'Accept: */*' \
-H 'x-auth-token: eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI3Yjc2OTg1ZGQ2MTNhOWVlYTFiN2RmZTNiZjRhMTRiZiIsImF1ZCI6IndlYiIsImV4cCI6MTYyOTI5MDcwNiwiaWF0IjoxNjI5Mjg4OTA2fQ.-Dj91d6fBZYcZpy1-zKzohAWd5dgW2CAS5BBfwGilemUYcOVDm8CnrDJHbwsFyixI5ohphy-65fqeobXkimtCg' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<enviNFe versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<idLote>739578</idLote>
<indSinc>1</indSinc>
<NFe>
<infNFe Id="NFe43140201098983010680557960000005991314477461" versao="4.00">
<ide>
<cUF>43</cUF>
<cNF>31447746</cNF>
<natOp>REVENDA DE MERCADORIAS SIMPLES NACIONAL - SC</natOp>
<mod>55</mod>
<serie>503</serie>
<nNF>739578</nNF>
<dhEmi>2023-01-24T17:55:28-03:00</dhEmi>
<tpNF>1</tpNF>
<idDest>1</idDest>
<cMunFG>4314902</cMunFG>
<tpImp>1</tpImp>
<tpEmis>1</tpEmis>
<tpAmb>2</tpAmb>
<finNFe>1</finNFe>
<indFinal>1</indFinal>
<indPres>1</indPres>
<indIntermed>0</indIntermed>
<procEmi>0</procEmi>
<verProc>OOBJ-NFE_EE</verProc>
</ide>
<emit>
<CNPJ>07385111000102</CNPJ>
<xNome>E-Sales Solucoes Oobj</xNome>
<enderEmit>
<xLgr>PROF ALGACYR MUNHOZ MADER</xLgr>
<nro>2800</nro>
<xBairro>CIC</xBairro>
<cMun>4314902</cMun>
<xMun>Porto Alegre</xMun>
<UF>RS</UF>
<CEP>81310020</CEP>
<cPais>1058</cPais>
<xPais>BRASIL</xPais>
<fone>4121098000</fone>
</enderEmit>
<IE>0963233556</IE>
<CRT>3</CRT>
</emit>
<dest>
<CNPJ>07385111000102</CNPJ>
<xNome>NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL</xNome>
<enderDest>
<xLgr>AV FRANCA</xLgr>
<nro>1162</nro>
<xCpl>SALA 201</xCpl>
<xBairro>NAVEGANTES</xBairro>
<cMun>4314902</cMun>
<xMun>PORTO ALEGRE</xMun>
<UF>RS</UF>
<CEP>90230220</CEP>
<cPais>1058</cPais>
<xPais>BRASIL</xPais>
<fone>5133373764</fone>
</enderDest>
<indIEDest>1</indIEDest>
<IE>0963233556</IE>
<IM>InsMun</IM>
<email>teste-sustentacao@oobj.com.br</email>
</dest>
<autXML>
<CPF>83448179191</CPF>
</autXML>
<autXML>
<CNPJ>01098983021453</CNPJ>
</autXML>
<det nItem="1">
<prod>
<cProd>4450</cProd>
<cEAN>SEM GTIN</cEAN>
<xProd>SISTEMA DE LINHA DE VIDA HORIZONTAIS RETRÁTEIS DE FÁCIL INSTALAÇÃO COM CAPACIDADE PARA DOIS OPERÁRIOS 18,3M DE CABO DE A</xProd>
<NCM>44170010</NCM>
<CEST>1300402</CEST>
<indEscala>S</indEscala>
<CFOP>5405</CFOP>
<uCom>PÇ</uCom>
<qCom>1</qCom>
<vUnCom>4298.43</vUnCom>
<vProd>4298.43</vProd>
<cEANTrib>SEM GTIN</cEANTrib>
<uTrib>PÇ</uTrib>
<qTrib>1</qTrib>
<vUnTrib>4298.43</vUnTrib>
<indTot>1</indTot>
<xPed>-1023368</xPed>
</prod>
<imposto>
<vTotTrib>0.00</vTotTrib>
<ICMS>
<ICMS00>
<orig>1</orig>
<CST>00</CST>
<modBC>0</modBC>
<vBC>4298.43</vBC>
<pICMS>4</pICMS>
<vICMS>171.94</vICMS>
</ICMS00>
</ICMS>
<PIS>
<PISOutr>
<CST>50</CST>
<vBC>4298.43</vBC>
<pPIS>1.65</pPIS>
<vPIS>70.92</vPIS>
</PISOutr>
</PIS>
<COFINS>
<COFINSOutr>
<CST>50</CST>
<vBC>4298.43</vBC>
<pCOFINS>7.60</pCOFINS>
<vCOFINS>326.68</vCOFINS>
</COFINSOutr>
</COFINS>
</imposto>
<infAdProd>STALAÇÃO COM CAPACIDADE PARA DOIS OPERÁRIOS 18,3M DE CABO DE AÇO - DBI REF:7605060 (CAPITAL SAFETY) - (COR: PRETO CLARO, TAM: ÚNICO))</infAdProd>
</det>
<total>
<ICMSTot>
<vBC>4298.43</vBC>
<vICMS>171.94</vICMS>
<vICMSDeson>0.00</vICMSDeson>
<vFCP>0.00</vFCP>
<vBCST>0.00</vBCST>
<vST>0.00</vST>
<vFCPST>0.00</vFCPST>
<vFCPSTRet>0.00</vFCPSTRet>
<vProd>4298.43</vProd>
<vFrete>0.00</vFrete>
<vSeg>0.00</vSeg>
<vDesc>0.00</vDesc>
<vII>0.00</vII>
<vIPI>0.00</vIPI>
<vIPIDevol>0.00</vIPIDevol>
<vPIS>70.92</vPIS>
<vCOFINS>326.68</vCOFINS>
<vOutro>0.00</vOutro>
<vNF>4298.43</vNF>
<vTotTrib>0.00</vTotTrib>
</ICMSTot>
</total>
<transp>
<modFrete>9</modFrete>
</transp>
<pag>
<detPag>
<tPag>01</tPag>
<vPag>4298.43</vPag>
</detPag>
</pag>
</infNFe>
</NFe>
</enviNFe>'
Exemplo de retorno
{
"mensagem": "/api/empresas/07385111000102/docs/hom/55/2023/503/000750165",
"tempoMedioMs": 1000,
"timestamp": 1682700456232
}
Ao receber o documento, a aplicação realiza uma validação e, caso esteja correto, envia-o para processamento pela Sefaz. Depois que a Sefaz processa o documento, o retorno é armazenado no banco de dados Oobj.
Pronto, você acaba de finalizar o processo de emitir um DFe! Siga para o artigo Como saber se a Sefaz emitiu meu documento?
