Consulta de Notas
Nesta seção é apresentado o download das notas fiscais de venda e retorno simbólico
A Americanas disponibiliza o Faturador Automático, uma funcionalidade que permite o faturamento da nota fiscal diretamente pelo marketplace após a aprovação do pagamento, isto é, com o Faturador Automático ativo na conta, a emissão da nota fiscal não parte da plataforma/ERP e sim do próprio marketplace.
Visto que existe a possibilidade de faturamento diretamente pelo marketplace, via API é possível realizar a consulta das notas fiscais geradas para pedidos Fulfillment.
A consulta de notas fiscais (de venda e retorno simbólico) será realizada através da aplicação do método GET para os endpoints que serão apresentados neste guia. Para os dois tipos de consulta/download serão utilizados os headers padronizados na API e visualizados a seguir:
Request headers:
X-User-Email
email_de_usuario
X-Api-Key
token_de_integracao de sua conta SkyHub
X-Accountmanager-Key
token_account único de cada Plataforma/ERP
Accept
application/json
Content-Type
application/json
GET - Download NFe de retorno simbólico
O retorno simbólico é utilizado para que o seller possa gerenciar com maior facilidade as baixas que ocorreram no sortimento encaminhado para um CD.
Exemplo: A loja encaminhou 50 unidades de um produto para o CD "BFF1114". A cada pedido gerado, será emitida uma nota de retorno simbólico (pelo Faturador Automático, por exemplo) que poderá ser baixada para auxiliar na contabilidade desse seller.
A consulta do retorno simbólico se dá através do GET, utilizando os headers padronizados na API, para o endpoint base:
https://api.skyhub.com.br/fulfillment/b2w/delivery/nfe?cd_vat_number={CNPJ_CD_DIRECT}&delivery={remote_code}Example request:
Response esperado:
GET - Download NFe de venda e retorno simbólico
A consulta apresentada a seguir retorna o XML das notas de venda e retorno simbólico, possibilitando a busca de notas emitidas pelo seller e enviadas via API ou emitidas pelo Faturador Automático.
A consulta das notas de venda e retorno simbólico se dá através do GET, utilizando os headers padronizados na API, para o endpoint base:
Example request:
Response esperado:
Filtros para download da NFe do seller
Ao se tratar de uma conta com muitas entregas para o serviço Fulfillment ou de uma consulta para um período longo de tempo pode ser necessário realizar a paginação dos resultados para visualização de todos os registros.
Através do /fulfillment/b2w/delivery/seller_nfe é possível utilizar os parâmetros page e page_size junto ao filtro obrigatório de datas para paginação da consulta das notas fiscais para o Fulfillment, sendo:
page
Indica o número da página de registros que será retornada. Caso não seja especificado, sempre será retornada a primeira página (valor padrão 0)
page_size
Indica a quantidade de registros que serão visualizados na página. O valor padrão é de 100 registros. Caso a conta possua mais de 100 entregas faz-se necessário acessar a(s) próxima(s) página(s) para visualização dos demais registros
Example request:
Response esperado:
Last updated