Seguir

Consultar Nota Fiscal de um pedido via API

 
Para listar todas NFes do Eccosys, você pode chamar o endpoint https://empresa.eccosys.com.br/api/nfes.
Para consultar uma NFe específica, você pode utilizar https://empresa.eccosys.com.br/api/nfes/<ID DA NFe>. Você pode utilizar tanto o ID da NFe como o número.
  
Consultando NFe a partir de um pedido

Para exemplificar, vamos supor que foi gerada um NFe de número 000001, referente ao pedido 98521569 de João da Silva. Este pedido tem número 2 no Eccosys.
 
Assim sendo, vamos ao fluxo:
 
Primeiramente, será necessário consultar as informações do pedidos, utilizando o seguinte endpoint:
GET https://empresa.eccosys.com.br/api/pedidos/<NUMERO DO PEDIDO> (todos os dados a seguir são fictícios e com intuito de somente exemplificar o retorno da API):
 
[
  {
    "id": "153612352",
    "idContato": "130521179",
    "data": "2016-12-25",
    "situacao": "1",
    "situacaoSecundaria": "0",
    "desconto": "0",
    "condicao": "",
    "observacoes": "Mercado-Livre",
    "totalProdutos": "0.13",
    "totalVenda": "0.13",
    "idOrigem": "0",
    "idPedidoOrigem": "0",
    "tipoPagamento": "",
    "numeroPedido": "2",
    "dataPrevista": "0000-00-00",
    "idVendedor": "0",
    "idCategoria": "0",
    "frete": "0.00",
    "primeiraCompra": "",
    "observacaoInterna": "",
    "dataFaturamento": "2017-01-04",
    "numeroDaOrdemDeCompra": "98521569",
    "idNotaFiscalRef": "131562832",
    "transportador": "",
    "fretePorConta": "",
    "valorIPI": "0.00",
    "valorST": "0.00",
    "opcEnderecoDiferente": "S",
    "paymentOrderID": "0",
    "codigoRastreamento": "",
    "dataCodigoRastreamento": "0000-00-00 00:00:00",
    "rastreamentoConcluido": "N",
    "pickingRealizado": "N",
    "qtdVolumes": "0",
    "pesoLiquido": "0.000",
    "pesoBruto": "0.000",
    "especieVolume": "",
    "situacaoDescricao": "",
    "dataPagamento": "0000-00-00",
    "formaFrete": "0",
    "pesoTransportadora": "0.000",
    "avisoRecebimento": "N",
    "maoPropria": "N",
    "possuiValorDeclarado": "N",
    "valorDeclarado": "0.0000000000",
    "statusAlterado": "S",
    "syncLogistica": "0",
    "confirmacaoLogistica": "N",
    "dtCriacaoVenda": "2016-12-25 09:11:32",
    "tipoObjeto": "",
    "dimensaoDiametro": "0",
    "dimensaoAltura": "0",
    "dimensaoLargura": "0",
    "dimensaoComprimento": "0",
    "idLojaVirtual": "0",
    "dataEnvioLogistica": "0000-00-00 00:00:00",
    "dataRecebimentoLogistica": "0000-00-00 00:00:00",
    "servicePlatformOrigin": "",
    "tipoPedido": "0",
    "pedidoDeServico": "0",
    "idMarketplaceIntegrado": "129962681",
    "idMarketplacePedidoMaster": "",
    "numeroNotaFiscal": "000001",
    "canalDeVenda": "Mercado Livre",
    "_OutroEndereco": {
      "id": "131376700",
      "idVenda": "131376699",
      "nome": "Antonio Silva",
      "endereco": "Rua Sete de Setembro",
      "enderecoNro": "100",
      "bairro": "Centro",
      "complemento": "",
      "cep": "25020190",
      "cidade": "Duque de Caxias",
      "idMunicipio": "256325",
      "uf": "RJ",
      "idPais": "0",
      "nomePais": "Brasil"
    },
    "pedidoColetado": false
  }
]
 
 
Quando a NFe é gerada, o Eccosys terá a situação como 1, o número da NFe estará não vazio e você poderá ver também o atributo idNotaFiscalRef, que é o ID da NFe no Eccosys.
 
Quando a nota estiver autorizada, você poderá usar os seguintes endpoints:
 
Devolvem os dados da NFe (em formato JSON):
 
https://empresa.eccosys.com.br/api/nfes/000001 (usando o número da NFe)
https://empresa.eccosys.com.br/api/nfes/131733832 (usando o ID da NFe)
 
Você pode utilizar os seguintes filtros na consulta de NFe:
$serie e $tipoNota ($tipoNota vai ser somente "E" para entrada, ou "S" para saída).
 
Exemplo de um consulta utilizando esses filtros:
https://empresa.eccosys.com.br/api/nfes/19742821?$serie=2&$tipoNota=S
 
Devolve o XML da NFe envolto em um JSON:
https://empresa.eccosys.com.br/api/xml-nfes/000001 (somente utilizando o número da NFe)
 
Exemplo de retorno:
{
  "xmls": [
    "<?xml version='1.0' encoding='UTF-8'?>..."
  ]
}
 
Devolve o PDF (já com content-type explicito de pdf) com a DANFE da NFe:
 
https://empresa.eccosys.com.br/api/danfes/000001/pdf (somente utilizando o número da NFe)
Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0
Tem mais dúvidas? Envie uma solicitação

0 Comentários

Por favor, entre para comentar.
Powered by Zendesk