POST Criar Prescritor

Cria um novo prescritor na Memed e persiste os dados localmente apenas em caso de sucesso. Retorna o token do prescritor.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Permissão necessária

Exige a permissão create_prescriptions_memed.

Alvo do cadastro

Cadastra o usuário informado em userId no corpo; se omitido, cadastra o próprio usuário autenticado.

---

Endpoint

POST https://api-dev.imagemais.com.br/api/integrations/memed/prescribers/create

---

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
cpf	string	✅	CPF do prescritor, exatamente 11 dígitos
boardCode	string	✅	Conselho: um de CRM, CRO, COREN, CRMV, CRF, CRN, CREFITO, CRP, CRFa, CREF
boardNumber	string	✅	Número do registro no conselho (somente dígitos)
boardState	string	✅	UF do registro, 2 letras
birthDate	string	✅	Data de nascimento no formato YYYY-MM-DD
especialidadeId	number	✅	ID da especialidade na Memed
especialidadeNome	string	✅	Nome da especialidade na Memed
sexo	string	❌	M ou F
userId	number	❌	Usuário alvo; usa o autenticado se omitido

Perfil do usuário precisa estar completo

O nome e o e-mail do usuário no sistema são usados no cadastro Memed. Se o usuário não tiver nome e sobrenome (nome com pelo menos duas palavras) ou não tiver e-mail, a rota retorna 400 antes de chamar a Memed.

---

Requisição

curl -X 'POST' \
  'https://api-dev.imagemais.com.br/api/integrations/memed/prescribers/create' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {accessToken}' \
  -d '{
  "cpf": "12345678900",
  "boardCode": "CRM",
  "boardNumber": "315435435",
  "boardState": "SP",
  "birthDate": "1972-09-05",
  "especialidadeId": 1,
  "especialidadeNome": "Cardiologia",
  "sexo": "M"
}'

---

Respostas

201 Sucesso

{
  "data": { "token": "abc123def456..." },
  "linked": true
}

400 Perfil incompleto ou dados recusados pela Memed

Retornado quando falta nome/sobrenome ou e-mail no cadastro do usuário, ou quando a Memed recusa os dados (o message traz o detail retornado pela Memed).

{
  "statusCode": 400,
  "message": "Seu perfil está incompleto: informe nome e sobrenome no seu cadastro antes de continuar."
}

500 Falha de conexão com a Memed

{
  "statusCode": 500,
  "message": "Erro de conexão com a Memed. Tente novamente mais tarde."
}