Orientação Faturamentos

A Netshoes disponibiliza a possibilidade de faturamento de pedidos via API, e assim unificar os processos junto as integradoras.
Para isso, disponibilizamos através do PUT /orders/{orderNumber}/shippings/{shippingCode}/status/invoiced, com a possibilidade de teste em ambiente SANDBOX.

Processamento API

Com a nova versão da api, não iremos ter alteração de contrato, porém alguns pontos devem ser levados em consideração:

  • Com a inclusão progressiva do sellers na nova versão da api, o campo já existente danfeXml passará a ter preenchimanto obrigatório;
  • O processamento de faturamento será totalmente assíncrono nesta nova versão, mais precisamente os seguintes processos:
    • Validação do conteúdo do campo danfeXml
    • Validação da Nota Fiscal do campo danfeXml e/ou das informações extras informadas no payload levando em consideração as informações do pedido associado na requisição
    • Faturamento e alteração do status do pedido;

Descrição API:

Headers:

  • client_id: APP Token usado para autenticar.
  • access_token: Access Token usado para autenticar.
  • orderNumber: Número do pedido.
  • shippingCode: Número de entrega do pedido.

Request Body:

  • issueDate: data de emissão da nota fiscal;
  • key: chave da nota fiscal, com 44 dígitos;
  • number: chave da nota fiscal, com 44 dígitos;
  • line: chave da nota fiscal, com 44 dígitos;
  • status: "Invoiced";
  • danfeXml: Campo xml com aspas "escapadas", isto é, com a tratativa das aspas duplas através de barra para evitar problemas de serialização do objeto;

Exemplo de Payload:

{
    "issueDate": "2024-04-05T18:56:21.935Z",
    "key": "35240562162876000191550011349002911873290408",
    "line": "35240562162876000191550011349002911873290408",
    "number": "35240562162876000191550011349002911873290408",
    "status": "Invoiced",
    "danfeXml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><protNFe versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><infProt><nProt>9999999999</nProt><digVal>9999999999999999999999</digVal><dhRecbto>2024-03-20T00:00:18-03:00</dhRecbto><Id>Id999999999999</Id><chNFe>35240562162876000191550011349002911873290408</chNFe><xMotivo>Autorizado o uso da NF-e</xMotivo><cStat>100</cStat></infProt></protNFe><NFe xmlns=\"http://www.portalfiscal.inf.br/nfe\"><infNFe Id=\"NFe35240562162876000191550011349002911873290408\" versao=\"4.00\"><infAdic><infCpl>netshoes: 121026073 | | 6534550 | Trib. aprox. R$: 16 14 Federal 21 59 Estadual Fonte: IBPT empresometro.com.br 4B7157</infCpl></infAdic><infRespTec><fone>5555555555</fone><CNPJ>000000000000</CNPJ><xContato>Name Contato</xContato><email>contato@contato.com.br</email></infRespTec><det nItem=\"1\"><prod><cEAN>SEM GTIN</cEAN><cProd>1445554</cProd><qCom>3.0000</qCom><cEANTrib>SEM GTIN</cEANTrib><vUnTrib>39.99</vUnTrib><qTrib>3.0000</qTrib><vProd>119.97</vProd><xProd>ISO PROTEIN INNOVATIVE NUTRIENTS RF 900G CARAMELO SALGADO</xProd><vUnCom>39.99</vUnCom><indTot>1</indTot><uTrib>UN</uTrib><NCM>21069030</NCM><uCom>UN</uCom><CFOP>6102</CFOP></prod><imposto><vTotTrib>37.73</vTotTrib><ICMS><ICMS00><modBC>3</modBC><orig>0</orig><CST>00</CST><vBC>119.97</vBC><vICMS>14.40</vICMS><pICMS>12.0000</pICMS></ICMS00></ICMS><ICMSUFDest><pICMSInter>12.00</pICMSInter><vICMSUFDest>0</vICMSUFDest><vICMSUFRemet>0</vICMSUFRemet><pICMSInterPart>100.0000</pICMSInterPart><vFCPUFDest>0</vFCPUFDest><pFCPUFDest>0</pFCPUFDest><vBCUFDest>14.40</vBCUFDest><pICMSUFDest>12.0000</pICMSUFDest></ICMSUFDest><COFINS><COFINSAliq><vCOFINS>8.02</vCOFINS><CST>01</CST><vBC>105.57</vBC><pCOFINS>7.6000</pCOFINS></COFINSAliq></COFINS><PIS><PISAliq><vPIS>1.74</vPIS><CST>01</CST><vBC>105.57</vBC><pPIS>1.6500</pPIS></PISAliq></PIS></imposto></det><total><ICMSTot><vCOFINS>8.02</vCOFINS><vBCST>0</vBCST><vICMSDeson>0</vICMSDeson><vProd>119.97</vProd><vSeg>0</vSeg><vFCP>0</vFCP><vFCPST>0</vFCPST><vNF>119.97</vNF><vTotTrib>37.73</vTotTrib><vPIS>1.74</vPIS><vIPIDevol>0</vIPIDevol><vBC>119.97</vBC><vST>0</vST><vICMS>14.40</vICMS><vII>0</vII><vFCPSTRet>0</vFCPSTRet><vDesc>0</vDesc><vOutro>0</vOutro><vIPI>0</vIPI><vFrete>0</vFrete></ICMSTot></total><pag><detPag><vPag>119.97</vPag><tPag>01</tPag></detPag></pag><ide><tpNF>1</tpNF><mod>55</mod><indPres>2</indPres><tpImp>1</tpImp><nNF>267271</nNF><cMunFG>3528502</cMunFG><procEmi>0</procEmi><finNFe>1</finNFe><dhEmi>2024-03-20T00:00:00-03:00</dhEmi><tpAmb>1</tpAmb><indFinal>1</indFinal><dhSaiEnt>2024-03-20T00:00:00-03:00</dhSaiEnt><idDest>2</idDest><tpEmis>1</tpEmis><cDV>9</cDV><cUF>35</cUF><serie>1</serie><natOp>VENDA DE MERCADORIA INTERESTADUAL (NAO CONTRIBUINTE)</natOp><cNF>999999</cNF><verProc>0.1.0</verProc><indIntermed>1</indIntermed></ide><infIntermed><CNPJ>000000000000</CNPJ><idCadIntTran>Central do Corpo</idCadIntTran></infIntermed><emit><xNome>CR NUTRITION SUPLEMENTOS EIRELI - MUSCLE BOX</xNome><CRT>3</CRT><xFant>CR NUTRITION SUPLEMENTOS EIRELI - MUSCLE BOX</xFant><CNPJ>000000000000</CNPJ><enderEmit><fone>999999999</fone><UF>SP</UF><xPais>Brasil</xPais><cPais>1058</cPais><xLgr>RUA DOS EXEMPLO - LOJA 01</xLgr><xMun>SAO PAULO</xMun><nro>450/460</nro><cMun>3528502</cMun><xBairro>EXEMPLO BAIRRO</xBairro><CEP>00000000</CEP></enderEmit><IE>99999999</IE></emit><dest><xNome>Name Teste</xNome><CPF>99999999</CPF><enderDest><UF>MG</UF><cPais>1058</cPais><xLgr>Praca Exemplo</xLgr><xMun>CIDADE EXEMPLO</xMun><nro>57</nro><cMun>3105608</cMun><xBairro>Bairro Exemplo</xBairro><CEP>9999999</CEP></enderDest><indIEDest>9</indIEDest></dest><transp><modFrete>1</modFrete><vol><esp>CAIXA</esp><qVol>1</qVol><pesoB>2.700</pesoB></vol></transp></infNFe></NFe></nfeProc>"
}

Validações feita pela aplicação:

  • Validação do pattern da chave da nota
  • Validação da data da emissão da nota, onde esta deve ser posterior a data de venda do pedido;
  • Caso seller já tenha sido migrado para esta nova versão: Obrigatória a presença do campo damfeXml;
  • Processo de validação da solicitação de faturamento caso já está sendo processada;
  • Caso a solicitação de faturamento tenha sido negada devido a um xml com dados não conforme, o status dos dados de Invoice do pedido irão ser atualizados com o status XML_ERROR, e uma nova soliticação de faturamento ou retificação da nota fiscal poderá ser feita;
  • Caso a solicitação de faturamento tenha sido negada devido à negativa na validação de nota fiscal, o status dos dados de Invoice do pedido irão ser atualizados com o status ERROR, e uma nova soliticação de faturamento ou retificação da nota fiscal poderá ser feita;
  • Pedidos Magalu Entregas somente irão ter solicitação de faturamento aceito caso o mesmo tenha sido aprovado quanto aos dados de XML e Nota fiscal;
  • Pedidos com entrega própria ao lojista, deverão ter apenas XML válidos para ter solicitação de faturamento aceito;
Importante:
  • O critério de aceite do processo de faturamento pela resposta da validação do XML será feita de maneira faseada;

Payloads de erros:

200 Success Pedido encontrado e solicitação de faturamento aceito pelo sistema;
400 Bad Request Payload de entrada não conforme;
401 Unauthorized Credenciais de autenticação fornecidas são inválidas.
403 Forbidden Não foi possível validar as credenciais de autenticação fornecidas.
404 Not Found Nenhum pedido encontrato com os parâmetros passados;
409 Conflict Erro de conflito para solicitações simultâneas para o mesmo orderNumber e idSeller;
500 Internal Server Error Erro de disponibilidade do serviço.

Payload de Retorno:

{
	"expands": [
		"items",
		"devolutionItems"
	],
	"shippingCode": 1960874464,
	"status": "Invoiced",
	"shippingEstimate": 1714446000000,
	"deliveryTime": 17,
	"freightAmount": 26.61,
	"country": "BR",
	"transport": {
		"expands": [],
		"trackingNumber": "",
		"trackingLink": "",
		"deliveryService": "Normal",
		"deliveryId": "52",
		"carrier": "CORREIOS",
		"carrierId": "103",
		"links": []
	},
	"invoice": {
		"expands": [],
		"accessKey": "35240406499597000147550011974556521660860965",
		"date": 1712343381000,
		"shipDate": 1713449322840,
		"volume": 1,
		"links": []
	},
	"customer": {
		"expands": [],
		"document": "19100000000",
		"stateInscription": "",
		"customerName": "Sheila  Polli",
		"recipientName": "Maria Josefa Farias",
		"tradeName": "",
		"cellPhone": "",
		"landLine": "(11)963409882",
		"address": {
			"expands": [],
			"neighborhood": "Centro",
			"postalCode": "59600115",
			"city": "MOSSORO",
			"state": "RN",
			"stateName": "RIO GRANDE DO NORTE",
			"street": "Avenida Getulio Vargas",
			"number": "294",
			"links": []
		},
		"links": []
	},
	"sender": {
		"expands": [],
		"supplierCnpj": "36101190000180",
		"sellerCode": 12782,
		"sellerName": "HMG - Tadashi Store",
		"supplierName": "HMG - Tadashi Store",
		"links": []
	},
	"platformId": "INTERNAL",
	"serviceId": "52",
	"serviceName": "Normal",
	"links": []
}