Como funciona a integração com o Eblood

Visão geral

A integração cobre um fluxo simples de três momentos. Não existe um endpoint de "cancelar requisição" separado — cancelar é só mais um valor de status, enviado no mesmo endpoint de atualização.

Conceitos para quem está começando

Se você já trabalha com integrações e APIs, pode pular direto para a Autenticação. Se esse é um dos seus primeiros contatos com o assunto, esses termos vão aparecer o tempo todo no resto da página — vale a pena ler uma vez.

Autenticação

Toda chamada para qualquer um dos três endpoints precisa levar o header Authorization no formato abaixo. Sem ele, ou com um token inválido, a requisição é recusada antes mesmo de chegar na lógica de criação ou atualização.

Authorization: Token token="{{TOKEN}}"

Criar requisição de hemocomponente

Recebe uma nova solicitação/prescrição gerada e liberada no sistema integrado. O Eblood localiza ou cria o paciente e cria a requisição correspondente. Corresponde à seção 2.1.1 da especificação técnica original.

O que acontece quando o médico não é encontrado

CD_MEDICO é resolvido por CRM. Se não encontrar um médico já cadastrado, o Eblood cadastra um médico novo automaticamente, usando NM_MEDICO (nome), UF_MEDICO (UF do CRM) e a especialidade cujo ans_code corresponde a CD_ESPECIALIDADE — por isso esses 3 campos só são obrigatórios nesse cenário. Se a especialidade não puder ser resolvida, ou se faltar NM_MEDICO/UF_MEDICO, o médico não é criado e a requisição inteira é recusada. Quando o médico já existe e CD_ESPECIALIDADE não bate com a especialidade já vinculada a ele, o médico é realocado para a especialidade correspondente — mas só se existir uma especialidade cadastrada com esse ans_code; caso contrário, a especialidade do médico não muda e a requisição não é rejeitada por isso.

O que acontece com clínica, convênio e cirurgia

Diferente do hospital, os campos DS_SETOR (clínica), DS_CONVENIO (convênio) e DS_CIRURGIA (cirurgia) são mais flexíveis: o Eblood procura um cadastro com esse nome (sem diferenciar maiúsculas/minúsculas) e, se não encontrar, cria um cadastro novo automaticamente. Nesses casos a requisição não é rejeitada — ela só fica marcada como incompleta nesse campo, para alguém revisar depois com calma.

Campos do payload

Os campos estão agrupados por assunto para facilitar a leitura. Clique em cada grupo para expandir.

Exemplo de chamada

curl -X POST "{{BASE_URL}}/api/v1/requisitions" \
  -H "Authorization: Token token=\"{{TOKEN}}\"" \
  -H "Content-Type: application/json" \
  -d '{
    "NR_PRESCRICAO": "12345678901234",
    "NM_PESSOA_FISICA": "MARIA DA SILVA SANTOS",
    "CD_MEDICO": "123456",
    "CD_ESTABELECIMENTO": "1",
    "IE_TIPO": "3"
  }'

{
    "NR_PRESCRICAO": "12345678901234",
    "NR_ATENDIMENTO": "987654321",
    "NM_PESSOA_FISICA": "MARIA DA SILVA SANTOS",
    "NM_SOCIAL": "MARIA SANTOS",
    "DT_NASCIMENTO": "1980-05-10",
    "IE_ESTADO_CIVIL": "2",
    "NR_CPF": "12345678901",
    "NR_SEQ_COR_PELE": "11",
    "IE_GRAU_INSTRUCAO": "4",
    "SEXO": "F",
    "CD_RELIGIAO": "2",
    "CD_NACIONALIDADE": "10",
    "CD_SETOR": "120",
    "DS_SETOR": "UTI ADULTO",
    "CD_ESTABELECIMENTO": "1",
    "CD_UNIDADE": "3N",
    "CD_AGENCIA": "1",
    "CD_CONVENIO": "45",
    "DS_CONVENIO": "BRADESCO SAUDE",
    "CD_MEDICO": "123456",
    "NM_MEDICO": "DR. JOAO OLIVEIRA",
    "UF_MEDICO": "SP",
    "CD_ESPECIALIDADE": "225124",
    "DS_DIAGNOSTICO": "Anemia por perda aguda de sangue",
    "IE_TIPO": "3",
    "IE_TIPO_PACIENTE": "C",
    "IE_RESERVA": "N",
    "DT_PROGRAMADA": "2026-08-18T10:00:00-03:00",
    "IE_PORTE_CIRURGICO": "M",
    "DT_CIRURGIA": "2026-08-18T08:00:00-03:00",
    "DS_CIRURGIA": "COLECISTECTOMIA VIDEOLAPAROSCOPICA",
    "DT_ULTIMA_TRANSF": "2025-01-15",
    "QT_TRANSF_ANTERIOR": 2,
    "NR_SEQ_REACAO": "3",
    "DS_HEMOCOMP_REACAO": "Concentrado de hemácias",
    "DS_COAGULOPATIA": "",
    "IE_GRAVIDEZ": "S",
    "QT_GRAVIDEZ": 2,
    "QT_ABORTO": 0,
    "IE_PRE_MEDICACAO": "S",
    "DS_PRE_MEDICACAO": "Dexclorfeniramina 5mg IV",
    "DS_OBSERVACAO": "Paciente com histórico de reação alérgica leve em transfusão anterior.",
    "QT_PLAQUETA": 180000,
    "QT_LEUCOCITOS": 6500,
    "QT_HEMOGLOBINA": 8.5,
    "QT_HEMATOCRITO": 27.3,
    "QT_TAP": 85.0,
    "QT_TAP_INR": 1.10,
    "QT_TTPA": 32.0,
    "QT_TTPA_REL": 1.05,
    "QT_FIBRINOGENIO": 280.5,
    "QT_ALBUMINA": 3.8,
    "QT_HEMOGLOBINA_S": 0.0,
    "QT_BILIRRUBINA_DIR": 0.3,
    "QT_BILIRRUBINA_IND": 0.7,
    "QT_MAGNESIO": 2.1,
    "QT_CALCIO": 9.0,
    "IE_COOMBS_DIRETO": "Negativo",
    "QT_IMC": 24.5,
    "QT_PESO": 65.500,
    "QT_ALTURA_CM": 163.0,
    "QT_FREQ_CARDIACA": 88,
    "QT_PA_SISTOLICA": 118,
    "QT_PA_DIASTOLICA": 76,
    "QT_TEMP": 36.5,
    "DS_ITEM_REQ": [
        { "external_id": "1001", "amount": 3 },
        { "external_id": "1002", "amount": 1 }
    ]
}

Respostas possíveis

{
    "id": "12345678901234",
    "date": "2026-08-18",
    "date_with_time": "2026-08-18T10:00:00-03:00",
    "room": "3N",
    "patient": {
        "id": 11024,
        "name": "MARIA DA SILVA SANTOS",
        "birthdate": "1980-05-10",
        "href": "/api/v1/patients/11024"
    },
    "hospital": {
        "id": 1,
        "name": "HOSPITAL EXEMPLO",
        "href": "/api/v1/hospitals/1"
    },
    "requirer": {
        "name": "DR. JOAO OLIVEIRA",
        "crm": "123456",
        "crm_uf": "SP"
    },
    "transfusion_type": "3",
    "hemocomponent_status": null,
    "hemoglobin": "8.5",
    "hematocrit": "27.3",
    "platelets": 180000
}

{
    "message": "Hospital não encontrado no Eblood para o CD_ESTABELECIMENTO informado: 1",
    "errors": []
}

{
    "message": "Physician name or crm não pode ser vazio",
    "errors": {
        "physician_name_or_crm": ["não pode ser vazio"]
    }
}

Atualizar status do hemocomponente

Registra a etapa de execução/infusão da requisição, conforme o sistema integrado for reportando. Também é este endpoint que cobre a suspensão da requisição — usando o código INT. Corresponde à seção 2.1.2 da especificação técnica original.

Valores aceitos

Exemplo de chamada

curl -X PUT "{{BASE_URL}}/api/v1/requisitions/12345678901234/update_status" \
  -H "Authorization: Token token=\"{{TOKEN}}\"" \
  -d "status=I"

{
    "status": "I"
}

Respostas possíveis

{
    "message": "Status successfully updated"
}

{
    "message": "Requisition 12345678901234: The received status (Z) is invalid"
}

Consultar requisição criada

Endpoint já existente no Eblood, útil para conferir — depois do POST de criação e do PUT de status — o estado final da requisição, incluindo o hemocomponent_status atual.

Exemplo de chamada

curl -X GET "{{BASE_URL}}/api/v1/requisitions/12345678901234" \
  -H "Authorization: Token token=\"{{TOKEN}}\""

Tabelas de domínio

Vários campos usam códigos numéricos ou de letra em vez de texto livre. Esta seção traz o significado de cada código. Os códigos são os mesmos da especificação original do sistema integrado — em alguns campos o Eblood traduz esse código para o seu próprio padrão interno (isso é indicado em cada tabela).

Erros comuns

Guia rápido para entender o que cada código de resposta quer dizer e o que fazer a respeito.

Perguntas frequentes