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

# Serviços Marketplace — Overview

> APIs HTTP com escopo de organização para integrações marketplace tipo service no Gu1 — produtos on-demand cobrados por request quando precificados.

## O que são serviços marketplace?

**Serviços marketplace** (`integration_type = service`) são produtos do catálogo que expõem **endpoints HTTP dedicados** no contexto da sua organização. Diferente de enrichments (que enriquecem o perfil da entidade), serviços respondem **consultas pontuais** invocadas pela sua integração.

O Gu1 atua como **proxy multi-tenant**: você autentica com a mesma API key ou sessão do restante da plataforma; o Gu1 resolve `organizationId`, verifica se o produto está **ativo para a org**, aplica billing quando configurado e devolve um envelope JSON normalizado.

## Path base

Todos os serviços compartilham este prefixo:

```
GET https://api.gu1.ai/api/integration-services/{integrationCode}/...
```

Substitua `{integrationCode}` pelo código de catálogo (por exemplo `ar_gueno_holder_intelligence_service`).

## Autenticação

Igual ao restante da API Gu1:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Chamadas via dashboard com sessão também são suportadas para a console; integradores normalmente usam API keys.

## Ativação

A organização deve **habilitar** a integração no Marketplace (mesmo fluxo de enrichments e listas).

## Envelope de resposta

Sucesso:

```json theme={null}
{
  "success": true,
  "data": { }
}
```

Erro:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Mensagem legível"
  }
}
```

## Cobrança

* **Endpoints gratuitos** (health, exists) não consomem pack nem créditos.
* **Endpoints cobráveis** cobram **uma unidade por request bem-sucedido** quando `base_price_cents > 0`.

## Auditoria

Cada chamada é registrada para a org. O CUIT do path **nunca** é persistido em texto claro na auditoria.

## Motor de regras

Vários serviços expõem campos em `services.{serviceKey}.*` em [Condições de regras](/pt/api-reference/rules/conditions).

## Serviços disponíveis

<CardGroup cols={2}>
  <Card title="Inteligência de Titulares CBU/CVU" icon="building-columns" href="/pt/api-reference/services/ar-gueno-holder-intelligence/overview">
    Totais CBU/CVU por CUIT (Argentina), janelas contratuais e métricas incrementais custom (Com. A 8298 BCRA).
  </Card>
</CardGroup>

## Documentação relacionada

* [Códigos de integração](/pt/api-reference/integrations/provider-codes)
* [Overview de enrichment](/pt/api-reference/enrichment/overview)
* [Autenticação](/pt/api-reference/authentication)