Guia: Identidade

Fluxos para buscar usuários internos da cooperativa e de companhias produtoras. A criação de usuários não é exposta via API de integração — apenas consultas.

Tipos de usuário

• Usuário da Cooperativa: funcionário da comercializadora/cooperativa. Buscado diretamente pelo CPF.
• Usuário Produtor: usuário interno de uma Companhia Produtora. A busca exige o producer_id e o CPF do usuário.

1. Buscar usuário da cooperativa por CPF

Endpoint: GET /api/v1/integration/cooperative-users/-/{social_id}:findBySocialId

curl -X GET \
  https://api.merx.tech/api/v1/integration/cooperative-users/-/98765432100:findBySocialId \
  -H "Authorization: {SUA_API_KEY}"

social_id é o CPF (somente números) do usuário interno. Retorna id, username, given_name, family_name, email, role, social_id, além de flags como enabled, email_verified, first_access.

Detalhes em Buscar usuário interno por CPF.

2. Listar usuários de uma Companhia Produtora

Endpoint: GET /api/v1/integration/producer-users/-/producers/{producer_id}

Retorna todos os usuários internos vinculados a um produtor.

curl -X GET \
  https://api.merx.tech/api/v1/integration/producer-users/-/producers/{producer_id} \
  -H "Authorization: {SUA_API_KEY}"

Detalhes em Listar usuários da Companhia Produtora.

3. Buscar usuário da Companhia Produtora por CPF

Endpoint: GET /api/v1/integration/producer-users/-/producers/{producer_id}/{social_id}:findBySocialId

Exige ambos producer_id e social_id no path.

curl -X GET \
  https://api.merx.tech/api/v1/integration/producer-users/-/producers/{producer_id}/98765432100:findBySocialId \
  -H "Authorization: {SUA_API_KEY}"

Detalhes em Buscar usuário da Companhia Produtora por CPF.

Observações

• Criação de usuários (cooperativa ou produtor) não está disponível na API de integração. Provisionamento é feito pelos canais administrativos da plataforma Merx.
• Para cadastrar um participante/signatário vinculado a uma Companhia Produtora (usado em fluxos de assinatura de contratos), consulte Cadastros §5.