Skip to main content

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

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

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.

Quem atende em mais de uma clínica

O prescritor Memed pertence à pessoa e vale em todas as clínicas dela. Se a pessoa do userId tem vínculo ativo em outra clínica, o administrador desta recebe 403 — "Essa pessoa também acessa outra clínica; esses dados só podem ser trocados por ela." Só a própria pessoa altera o seu prescritor.


Endpoint​

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

Corpo da Requisição​

CampoTipoObrigatórioDescrição
cpfstring✅CPF do prescritor, exatamente 11 dígitos
boardCodestring✅Conselho: um de CRM, CRO, COREN, CRMV, CRF, CRN, CREFITO, CRP, CRFa, CREF
boardNumberstring✅Número do registro no conselho (somente dígitos)
boardStatestring✅UF do registro, 2 letras
birthDatestring✅Data de nascimento no formato YYYY-MM-DD
especialidadeIdnumber✅ID da especialidade na Memed
especialidadeNomestring✅Nome da especialidade na Memed
sexostring❌M ou F
userIdnumber❌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."
}