> 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/sac/integracao-sac.md).

# > Integração SAC

{% 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 endpoint `/sac` permite a consulta de tickets e instâncias abertos no marketplace, assim como a interação entre *seller* e cliente. 

Para atuação com o SAC é importante ter a ciência de que as consultas são separadas em: **tickets** e **instâncias**: Para os **tickets** (entende-se ticket como o SAC que gerou troca de mensagens entre cliente e *seller*/marketplace), será utilizada a consulta geral no endpoint `/sac`, enquanto que as **instâncias** abertas e que não possuíram nenhum tipo de interação, ou seja, não geraram trocas de mensagens, serão visualizadas apenas através do endpoint `/sac/{code}/instances`.

## Passos para integração do SAC

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

1. Consulta de atendimentos;
2. Fornecer interações para um ticket;
3. Atualizar o status do atendimento;
4. Consultar as instâncias abertas.

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

* [Consulta de atendimentos](/sac/listar_sac.md): Para a homologação do recurso será validada a capacidade do sistema de consultar os tickets disponíveis na conta, assim como a aplicação de filtros de pesquisa;
* [Fornecer interações para um ticket](/sac/chats.md): Através da homologação, será analisada a requisição para interação via `/sac`;
* [Atualizar o status do atendimento](/sac/chats.md): Via API é possível encaminhar requisições contendo o método PATCH para a atualização de status de um atendimento e esta ação será validada para a homologação do recurso;
* [Consultar as instâncias abertas](/sac/instancias_sac.md): A visualização de instâncias não se dá através da consulta geral dos atendimentos abertos para a conta; para estas, faz-se necessária a consulta do endpoint `/instances`, ação que será validada para a homologação.

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

{% content-ref url="/pages/-M1RlEm7jSk6FQukEWdu" %}
[Listar SAC](/sac/listar_sac.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M2-sz1tc2FZjSh6fgdW" %}
[Chats](/sac/chats.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M1aFvO\_vRanMboacmb1" %}
[Consulta de Itens](/sac/items.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M1WfWVWc51TWrvM-\_SO" %}
[Instâncias geradas de SAC](/sac/instancias_sac.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M1b7q5C0NlojPLzkU7W" %}
[Actions](/sac/actions.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M1bTh8Ab96qOCNimhhU" %}
[Refunds](/sac/refunds.md)
{% endcontent-ref %}