> ## Documentation Index
> Fetch the complete documentation index at: https://pedirgasdocs.supergasbras.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Ofertas e composição: recomendações e relatórios

> Entenda como a Composition API da Supergasbras fornece ofertas recomendadas para consumidores e relatórios financeiros para revendedores.

A Composition API da Supergasbras combina múltiplos serviços para oferecer dois recursos principais: **ofertas recomendadas** para consumidores e **relatórios financeiros** para revendedores (dealers).

## Ofertas recomendadas

O endpoint de ofertas retorna uma lista personalizada de produtos e promoções recomendados para o consumidor. Use este endpoint para exibir ofertas relevantes na sua interface antes ou durante o processo de compra.

```bash theme={null}
curl -X GET "https://composition-ms.supergasbras.app/consumers/v1/offers" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"
```

A resposta inclui as ofertas disponíveis para o consumidor autenticado, permitindo que você apresente promoções contextuais no momento certo da jornada de compra.

## Relatórios financeiros para revendedores

Revendedores (dealers) podem enviar relatórios financeiros através da Composition API. Este endpoint é utilizado para registrar e transmitir informações de pagamento da revenda para a Supergasbras.

```bash theme={null}
curl -X POST "https://composition-ms.supergasbras.app/dealers/v1/payment/report" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "dealerId": "DEALER_ID",
    "reportData": {}
  }'
```

## Casos de uso

<CardGroup cols={2}>
  <Card title="Consumidores" icon="user" href="/api-reference/composition/offers">
    Exiba ofertas recomendadas na tela inicial ou durante o processo de seleção de produtos para aumentar a conversão.
  </Card>

  <Card title="Revendedores" icon="store" href="/api-reference/composition/dealers">
    Integre o envio automatizado de relatórios financeiros para manter o histórico de transações atualizado com a Supergasbras.
  </Card>
</CardGroup>

<Tip>
  Consulte as ofertas antes de criar a sessão de carrinho para exibir os produtos mais relevantes ao cliente desde o início da jornada.
</Tip>