# > 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**).&#x20;

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;&#x20;
* [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.&#x20;

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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://desenvolvedores.skyhub.com.br/americanas-fulfillment/integracao-fulfillment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
