> For the complete documentation index, see [llms.txt](https://desenvolvedores.skyhub.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://desenvolvedores.skyhub.com.br/americanas-fulfillment/integracao-fulfillment.md).

# > Integração Fulfillment

{% hint style="danger" %}
**Todo recurso desenvolvido deve ser** [**homologado**](https://desenvolvedores.skyhub.com.br/processo-de-homologacao) **pelo time responsável pela API da Americanas.**
{% endhint %}

## O que é o Americanas Fulfillment?

O Fulfillment é a solução completa de logística oferecida pelo marketplace Americanas, incluindo o auxílio a escolha do sortimento, recebimento de mercadorias, armazenagem, emissão de notas fiscais, separação e expedição do pedido. Ainda, o marketplace fornece atendimento pós-venda e cuida da logística reversa, quando necessário.

Estão disponíveis via API funcionalidades que visam automatizar o serviço Fulfillment, proporcionando melhor gerenciamento através da integração, como consulta do estoque existente no Centro de Distribuição (CD), faturamento de pedidos, cadastro do Faturador (responsável pela definição de regras fiscais e tributárias) e download de notas fiscais.

## Passos para integração do Americanas Fulfillment

O processo de homologação para o serviço Fulfillment difere de acordo com o perfil do sistema: Quando se trata da homologação para um **ERP** é possível incluir tarefas referentes ao **Faturador**, responsável pelo cadastro de regras fiscais e tributárias, além das demais tratativas para o serviço, como consulta de estoque, faturamento do pedido e download de notas fiscais (ações solicitadas para a homologação de **plataformas**). 

Os passos para homologação deste recurso são:

1. Criação e faturamento de um pedido referente ao serviço Fulfillment;
2. Download de notas fiscais;
3. Consulta de estoque;
4. Cadastro e atualização de regras fiscais e tributárias (etapa solicitada exclusivamente para ERP);
5. Criação de vínculo entre regras tributárias e produtos (etapa solicitada exclusivamente para ERP).

### O que será validado durante o processo de homologação?

Durante o processo de homologação serão validados os aspectos citados acima, sendo:

* [Criação de um pedido Fulfillment](https://desenvolvedores.skyhub.com.br/pedidos/criacao-de-pedido-teste#pedido-fulfillment): Pedidos gerados para o serviço Fulfillment podem ser distinguidos através do campo `shipping_method` e para a homologação do recurso será validado o correto preenchimento deste campo;
* [Faturamento de um pedido Fulfillment](https://desenvolvedores.skyhub.com.br/americanas-fulfillment/faturamento): Para a homologação será validado se a plataforma/ERP está apta a utilizar o correto endpoint para faturamento de pedidos gerados para o serviço Fulfillment;
* [Consulta de notas fiscais](https://desenvolvedores.skyhub.com.br/americanas-fulfillment/faturamento#download-nfe-de-retorno-simbolico): Uma vez que o *seller* tem a opção de solicitar que o marketplace realize o faturamento de seus pedidos, é imprescindível que a plataforma/ERP seja capaz de realizar o download de notas fiscais; 
* [Consulta de estoque](https://desenvolvedores.skyhub.com.br/americanas-fulfillment/consulta-estoque-fulfillment): Visto que os produtos selecionados pelo *seller* serão armazenados em Centros de Distribuição (CDs) disponibilizados pela Americanas, é importante que haja a consulta do estoque destes itens para melhor gerenciamento da loja;
* [Aplicação de regras fiscais e tributárias](https://desenvolvedores.skyhub.com.br/americanas-fulfillment/faturador): É possível que o *seller* defina via API as regras fiscais e tributárias para faturamento de pedidos gerados para o Fulfillment. 

Navegue pelas guias abaixo para acompanhar cada ação disponível via API para o serviço Fulfillment:

{% content-ref url="/pages/-MfO-bt9nYm3mRAtLOAE" %}
[Consulta de Estoque](/americanas-fulfillment/consulta-estoque-fulfillment.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MfO-UNi64mt2KD2ucp9" %}
[Identificando Pedido](/americanas-fulfillment/identificando-pedido.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MfO-mA8wHk52AWmG1Cm" %}
[Faturamento](/americanas-fulfillment/faturamento.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MckInSHUCsKndSezq7J" %}
[Faturador](/americanas-fulfillment/faturador.md)
{% endcontent-ref %}