> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/pt-br/partner-api-overview/onboarding-checklist.md).

# Lista de verificação de integração

## Pré-requisitos e configuração de acesso

### Acesso necessário

| Tarefa                                                                                                                                                                                        | Status |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| O acesso ao namespace é gerenciado no nível da equipe. Para solicitar acesso, forneça o namespace e os detalhes do ambiente (por exemplo, `EU3_retailerco`) para a Epsilon Equipe de suporte. | ☐      |
| Certifique-se de ter associação na equipe correta do fornecedor ou do varejista principal. O acesso à equipe apropriada é necessário para gerar o token de API.                               | ☐      |
| Solicitação de entrada de API enviada (KB0040933).                                                                                                                                            | ☐      |
| Acesso à API de relatórios (BigQuery) solicitado, se necessário.                                                                                                                              | ☐      |
| Chave de usuário recuperada das configurações do perfil.                                                                                                                                      | ☐      |
| URL base obtida da equipe de suporte.                                                                                                                                                         | ☐      |

### Configuração do ambiente

| Tarefa                                                                                                                                                                                                                                                  | Status |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| <p>URL da API do ambiente sandbox confirmada.<br>(Entre em contato com o Service Desk para confirmar o domínio de sandbox correto para sua conta).</p>                                                                                                  | ☐      |
| <p>URLs do ambiente confirmadas.<br>(Entre em contato com o Service Desk para confirmar o domínio de ambiente correto para sua conta).</p>                                                                                                              | ☐      |
| <p>Os metadados necessários (catálogo de produtos, posicionamento, informações da equipe) são verificados por:<br><br>- Abertura de um chamado no Service Desk, ou<br>- Acesso às tabelas do BigQuery: dim\_product, dim\_catalog e dim\_placement.</p> | ☐      |

## Autenticação e integração principal

### Configuração de autenticação

| Tarefa                                                              | Status |
| ------------------------------------------------------------------- | ------ |
| Token de autenticação de chave de usuário implementado.             | ☐      |
| Recuperação de token de acesso funcionando (expiração de 24 horas). | ☐      |
| Cabeçalhos de autenticação configurados corretamente.               | ☐      |
| Autenticação de sandbox testada.                                    | ☐      |

### Integração principal de API

| Tarefa                                                     | Status |
| ---------------------------------------------------------- | ------ |
| Endpoints de gerenciamento de campanha integrados.         | ☐      |
| Endpoints de gerenciamento de equipe e usuário integrados. | ☐      |
| Endpoints de gerenciamento de carteira integrados.         | ☐      |
| Endpoints de padrão de conteúdo integrados.                | ☐      |
| Endpoints de API de operação em lote configurados.         | ☐      |

### Validação de formato de dados

| Tarefa                                                                        | Status |
| ----------------------------------------------------------------------------- | ------ |
| Estruturas de payload JSON validadas.                                         | ☐      |
| Mapeamentos de campos obrigatórios concluídos.                                | ☐      |
| Definições de campos de campanha compreendidas.                               | ☐      |
| Requisitos de ativos criativos verificados (< 4MB, PNG/JPEG/JPG/GIF/SVG/PDF). | ☐      |
| Formato de carimbo de data/hora ISO-8601 implementado.                        | ☐      |

## Testes de campanha e recursos

### Testes de campanha

| Tarefa                                                                                                                                    | Status |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| Criação de Sponsored Product Ads (SPA) testada.                                                                                           | ☐      |
| Criação de campanha de banner testada.                                                                                                    | ☐      |
| Banner X criação de campanha testada.                                                                                                     | ☐      |
| Mudanças de estado de aprovação de campanha testadas (necessário apenas para integrações de Varejistas; não aplicável para Fornecedores). | ☐      |
| Operações de campanha em lote testadas (opcional, com base no caso de uso).                                                               | ☐      |

### Testes de carteira e equipe

| Tarefa                                           | Status |
| ------------------------------------------------ | ------ |
| Criação e gerenciamento de carteira testados.    | ☐      |
| Operações de gerenciamento de fundos testadas.   | ☐      |
| Criação de equipe e convite de usuário testados. | ☐      |
| Modificações de permissão de usuário testadas.   | ☐      |
| Endpoints de cálculo de gastos testados.         | ☐      |

### Testes de arquivos e ativos

| Tarefa                                                 | Status |
| ------------------------------------------------------ | ------ |
| Uploads de ativos criativos testados.                  | ☐      |
| Validação de tamanho e formato de arquivo funcionando. | ☐      |
| Recuperação de padrão de conteúdo testada.             | ☐      |
| Uploads de logotipo para equipes/usuários testados.    | ☐      |

## Implementação de melhores práticas

| Tarefa                                               | Status |
| ---------------------------------------------------- | ------ |
| Endpoints em lote usados para operações múltiplas.   | ☐      |
| Arquivos compactados implementados para uploads.     | ☐      |
| Tratamento de erros com respostas JSON estruturadas. | ☐      |
| Validação de campos antes do envio da requisição.    | ☐      |

## Monitoramento e suporte

| Tarefa                                                  | Status |
| ------------------------------------------------------- | ------ |
| Monitoramento de chamadas de API implementado.          | ☐      |
| Registro de erros e alertas configurados.               | ☐      |
| Configuração do rastreamento de métricas de desempenho. | ☐      |
| Informações de contato do suporte documentadas.         | ☐      |
| Procedimentos de escalonamento estabelecidos.           | ☐      |

## Lista de verificação de requisitos

### Indispensável antes de entrar em operação

| Tarefa                                                                                      | Status |
| ------------------------------------------------------------------------------------------- | ------ |
| Autenticação por chave de usuário funcionando em produção.                                  | ☐      |
| Criação de campanha (SPA/Banner/Banner X) funcional.                                        | ☐      |
| Uploads de arquivos de criativo funcionando (limite < 4MB).                                 | ☐      |
| Tratamento de erros para todos os códigos de status HTTP.                                   | ☐      |
| Operações em lote testadas para eficiência.                                                 | ☐      |
| Padrões de conteúdo e posicionamentos validados (incluindo verificação de componentes PDF). | ☐      |

### Validações específicas de API

| Tarefa                                                           | Status |
| ---------------------------------------------------------------- | ------ |
| Acesso ao namespace confirmado.                                  | ☐      |
| Afiliação de equipe e permissões verificadas.                    | ☐      |
| Metadados necessários (catálogo, posicionamento) disponíveis.    | ☐      |
| Acesso ao BigQuery para relatórios (se necessário).              | ☐      |
| Validação de formato de arquivo (PNG, JPEG, JPG, GIF, SVG, PDF). | ☐      |
| Conformidade com o formato de carimbo de data/hora ISO-8601.     | ☐      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/partner/pt-br/partner-api-overview/onboarding-checklist.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.