Como funciona a integração com o Eblood
Este guia explica, passo a passo e sem pressupor experiência prévia com APIs, como o sistema integrado envia pedidos de hemocomponentes para o Eblood e como o status dessas requisições é atualizado depois.
Configure suas credenciais
Preencha os dois campos abaixo com a sua URL base e o seu token de acesso. Todos os exemplos de código desta página são atualizados automaticamente com esses valores — assim você já sai daqui com comandos prontos para usar, sem precisar trocar nada na mão.
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.
Não existe um endpoint próprio para "suspender" ou cancelar uma requisição: basta enviar o status INT (Interrompido) no endpoint de atualização de status (passo 2 acima).
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.
Uma forma padronizada de dois sistemas conversarem entre si pela internet. Aqui, é como o sistema integrado "fala" com o sistema do Eblood.
Um endereço específico da API que faz uma coisa. Esta integração usa três: criar requisição, atualizar status e consultar requisição.
Indica a intenção da chamada. POST cria algo novo, PUT atualiza algo que já existe, GET apenas consulta, sem alterar nada.
Uma informação extra enviada "por fora" do conteúdo principal da requisição — aqui, é onde vai o token de autenticação.
O formato de texto usado para enviar e receber os dados. É uma lista de "campo": valor entre chaves, como nos exemplos desta página.
Um número de 3 dígitos que a resposta traz dizendo o que aconteceu. Começa com 2 quando deu certo (ex: 201) e com 4 quando algo no pedido estava errado (ex: 422).
Uma senha de acesso da API. Só quem tem o token correto consegue usar os endpoints — sem ele, o pedido é recusado antes mesmo de chegar na lógica da integração.
Um comando de terminal usado para testar chamadas de API rapidamente, sem precisar programar. Os exemplos desta página trazem esse comando pronto.
Autenticação
Toda chamada para qualquer um dos endpoints desta documentação 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 — com 401 e corpo em texto puro (não JSON): HTTP Token: Access denied.
Authorization: Token token="{{TOKEN}}"
O token é combinado previamente com o Eblood e enviado só no header — ele nunca aparece dentro do corpo (body) JSON da requisição.
Os PUTs de atualização de status (seções 05 e 06) aceitam tanto application/x-www-form-urlencoded (formato usado nos exemplos cURL com -d) quanto application/json — escolha o que for mais prático no seu lado. O POST de criação (seção 04) foi testado e documentado só como application/json; use esse formato para evitar surpresas com os campos aninhados de DS_ITEM_REQ.
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.
NR_PRESCRICAO, NM_PESSOA_FISICA (apenas quando o paciente ainda não existe — ver a tabela abaixo), CD_MEDICO, CD_ESTABELECIMENTO e IE_TIPO. Faltando qualquer um deles, se o hospital não for encontrado, ou se o médico não existir e não for possível cadastrá-lo automaticamente (ver abaixo), a requisição inteira é recusada com 422.
Na prática, DS_CONVENIO também é obrigatório: toda requisição criada por esta API assume cobrança por convênio por padrão. Se DS_CONVENIO vier vazio, não há convênio para resolver e a requisição é recusada com 422 ("Health insurance name não pode ser vazio").
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 revisão posterior.
A categoria da clínica (campo interno obrigatório no cadastro do Eblood, mas sem equivalente no sistema integrado) não é enviada pelo DS_SETOR. Quando uma clínica nova é criada automaticamente, ela recebe a categoria padrão Clínica Médica — a categoria pode ser ajustada depois pela tela de cadastro de clínicas do Eblood.
Formatos e tipos de campo
| Tipo de campo | Formato aceito |
|---|---|
| Datas sem hora DT_NASCIMENTO, DT_ULTIMA_TRANSF, DT_CIRURGIA | AAAA-MM-DD (ex: 1980-05-10). Enviar um timestamp completo também funciona, mas a hora é descartada — só a data é usada. |
| Data com hora DT_PROGRAMADA | AAAA-MM-DDTHH:MM:SS-03:00 (ISO 8601 com fuso) — esse campo alimenta dois campos internos ao mesmo tempo, um só de data e outro de data+hora. Enviando só a data (sem hora), o campo de data+hora fica registrado à meia-noite. |
| NR_CPF | Exatamente 00000000000 (11 dígitos) ou 000.000.000-00 (com pontuação completa) — formatos parciais ou com espaços são rejeitados. Também precisa passar na validação de dígito verificador do CPF. |
| CD_MEDICO (CRM) | Só dígitos, até 10 caracteres. |
| Campos QT_* (sinais vitais, exames laboratoriais, peso, altura etc.) | Aceitam tanto número (8.5) quanto string ("8.5") no JSON — o Eblood converte automaticamente para o tipo correto (inteiro ou decimal) ao salvar. |
Campos do payload
Os campos estão agrupados por assunto para facilitar a leitura. Clique em cada grupo para expandir.
Identificação da requisição (2 campos)
| Campo | Obrigatório | O que é |
|---|---|---|
| NR_PRESCRICAO | Sim | Identificador da prescrição no sistema integrado. Vira o id da requisição no Eblood — entre 6 e 14 caracteres, e precisa ser único (uma requisição já existente com o mesmo valor é recusada com 422). |
| NR_ATENDIMENTO | Não | Número de atendimento do paciente no sistema integrado. |
Dados do paciente (10 campos)
| Campo | Obrigatório | O que é |
|---|---|---|
| NM_PESSOA_FISICA | Condicional | Nome civil do paciente. Obrigatório apenas quando NR_CPF não bate com nenhum paciente já cadastrado (paciente novo) — nesse caso, se vier vazio, a requisição é recusada. Se o CPF já existir, este campo pode vir vazio sem rejeitar a requisição, mas também não atualiza o nome do cadastro existente. |
| NM_SOCIAL | Não | Nome social do paciente. |
| DT_NASCIMENTO | Não | Data de nascimento. |
| NR_CPF | Não | CPF do paciente — usado para localizar ou criar o cadastro. |
| SEXO | Não | Sexo do paciente (M/F). |
| IE_ESTADO_CIVIL | Não | Estado civil. Código do sistema integrado, traduzido para o código já usado no Eblood — ver tabela de domínio. |
| NR_SEQ_COR_PELE | Não | Cor/raça. Código do sistema integrado, traduzido para o código do Eblood — ver tabela de domínio. |
| IE_GRAU_INSTRUCAO | Não | Grau de instrução. Código do sistema integrado, traduzido para o código do Eblood — ver tabela de domínio. |
| CD_RELIGIAO | Não | Religião. Código idêntico ao do Eblood, sem tradução — ver tabela de domínio. Um código fora do domínio: se o paciente é novo, rejeita a requisição com 422 (ex: "errors": ["Religion code não está incluso na lista"]); se o paciente já existe, o código inválido é apenas ignorado, sem erro. |
| CD_NACIONALIDADE | Não | Nacionalidade — ver tabela de domínio. |
Local de atendimento (5 campos)
| Campo | Obrigatório | O que é |
|---|---|---|
| CD_ESTABELECIMENTO | Sim | Identifica o hospital pelo código já cadastrado no Eblood. Se não encontrado, a requisição inteira é recusada. |
| DS_SETOR | Não | Nome da clínica/setor. Localizado por nome; se não existir, é criado automaticamente. |
| CD_SETOR | Não | Código do setor no sistema integrado. Gravado apenas para auditoria — quem resolve a clínica de fato é DS_SETOR. |
| CD_UNIDADE | Não | Quarto/leito do paciente. Não confundir com CD_ESTABELECIMENTO — nomes parecidos, campos bem diferentes. |
| CD_AGENCIA | Não | Id da agência à qual a requisição fica atrelada. Se omitido, usa a primeira agência cadastrada. |
Convênio e médico (6 campos)
| Campo | Obrigatório | O que é |
|---|---|---|
| CD_MEDICO | Sim | CRM do médico — resolvido por lookup. Se não for encontrado, o Eblood cadastra um médico novo automaticamente usando NM_MEDICO, UF_MEDICO e CD_ESPECIALIDADE. Se não for possível criar (por exemplo, faltando algum desses campos), a requisição inteira é recusada. |
| NM_MEDICO | Condicional | Nome do médico. Obrigatório só quando CD_MEDICO ainda não tem cadastro no Eblood — usado apenas para criar o médico novo. |
| UF_MEDICO | Condicional | UF do CRM. Obrigatório só quando CD_MEDICO ainda não tem cadastro no Eblood. Mesmo quando o médico já existe, envie sempre que souber: como o mesmo número de CRM pode existir em UFs diferentes (são médicos distintos), enviar UF_MEDICO garante que o médico certo seja escolhido. |
| CD_ESPECIALIDADE | Condicional | Comparado ao ans_code da especialidade já vinculada ao médico; se não bater, o médico é realocado — mas só se existir uma especialidade cadastrada com esse código. Obrigatório só quando CD_MEDICO ainda não tem cadastro no Eblood (usado para criar o médico). |
| DS_CONVENIO | Condicional | Nome do convênio. Localizado por nome; se não existir, é criado automaticamente. Na prática é obrigatório: toda requisição criada por esta API assume cobrança por convênio, então se este campo vier vazio a requisição é recusada — ver aviso no topo da seção. |
| CD_CONVENIO | Não | Código do convênio no sistema integrado. Gravado apenas para auditoria — quem resolve o convênio de fato é DS_CONVENIO. |
Dados clínicos gerais (8 campos)
| Campo | Obrigatório | O que é |
|---|---|---|
| IE_TIPO | Sim | Tipo de transfusão. Traduzido para o código do Eblood — ver tabela de domínio. Ignorado quando IE_RESERVA é S. |
| IE_RESERVA | Não | S/N. Quando S, força o tipo para "Reserva" e ignora IE_TIPO. |
| IE_TIPO_PACIENTE | Não | Clínico (C) ou Cirúrgico (I) — ver tabela de domínio. |
| DS_DIAGNOSTICO | Não | Descrição do diagnóstico. |
| DT_PROGRAMADA | Não | Data/hora programada da transfusão. |
| IE_PORTE_CIRURGICO | Não | Porte da cirurgia — ver tabela de domínio. |
| DT_CIRURGIA | Não | Data/hora da cirurgia. |
| DS_CIRURGIA | Não | Nome da cirurgia. Localizada por nome; se não existir, é criada automaticamente. |
Histórico do paciente (8 campos)
| Campo | Obrigatório | O que é |
|---|---|---|
| DT_ULTIMA_TRANSF | Não | Data da última transfusão. Fica salvo no cadastro do paciente, não na requisição pontual. |
| QT_TRANSF_ANTERIOR | Não | Quantidade de transfusões anteriores. |
| NR_SEQ_REACAO | Não | Tipo de reação prévia — ver tabela de domínio. |
| DS_HEMOCOMP_REACAO | Não | Hemocomponente que causou a reação prévia. |
| DS_COAGULOPATIA | Não | Coagulopatia documentada. |
| IE_GRAVIDEZ | Não | Histórico de gravidez — ver tabela de domínio. |
| QT_GRAVIDEZ | Não | Quantidade de gestações. |
| QT_ABORTO | Não | Quantidade de abortos. |
Pré-medicação e observações (3 campos)
| Campo | Obrigatório | O que é |
|---|---|---|
| IE_PRE_MEDICACAO | Não | Houve pré-medicação (S/N). |
| DS_PRE_MEDICACAO | Não | Descrição da pré-medicação. |
| DS_OBSERVACAO | Não | Observações gerais da prescrição. |
Exames laboratoriais (16 campos)
Todos opcionais. Valores numéricos de exames — o nome do campo já indica o exame.
| Campo | Exame |
|---|---|
| QT_PLAQUETA | Contagem de plaquetas |
| QT_LEUCOCITOS | Contagem de leucócitos |
| QT_HEMOGLOBINA | Taxa de hemoglobina (g/dL) |
| QT_HEMATOCRITO | Taxa de hematócrito (%) |
| QT_TAP | Tempo de atividade da protrombina (%) |
| QT_TAP_INR | INR do tempo de protrombina |
| QT_TTPA | TTPa, em segundos |
| QT_TTPA_REL | Relação paciente/normal do TTPa |
| QT_FIBRINOGENIO | Dosagem de fibrinogênio |
| QT_ALBUMINA | Albumina sérica (g/dL) |
| QT_HEMOGLOBINA_S | Hemoglobina S (%) |
| QT_BILIRRUBINA_DIR | Bilirrubina direta (mg/dL) |
| QT_BILIRRUBINA_IND | Bilirrubina indireta (mg/dL) |
| QT_MAGNESIO | Magnésio (mg/dL) |
| QT_CALCIO | Cálcio (mg/dL) |
| IE_COOMBS_DIRETO | Resultado do Coombs Direto |
Sinais vitais e antropometria (7 campos)
Todos opcionais.
| Campo | O que é |
|---|---|
| QT_IMC | Índice de Massa Corporal |
| QT_PESO | Peso em kg |
| QT_ALTURA_CM | Altura em cm |
| QT_FREQ_CARDIACA | Frequência cardíaca |
| QT_PA_SISTOLICA | Pressão arterial sistólica |
| QT_PA_DIASTOLICA | Pressão arterial diastólica |
| QT_TEMP | Temperatura corporal (°C) |
Itens solicitados (1 campo, obrigatório se houver itens)
| Campo | O que é |
|---|---|
| DS_ITEM_REQ | Lista dos hemocomponentes pendentes, no formato [{"external_id": "1001", "amount": 3}]. Cada external_id é procurado no cadastro de hemocomponentes do Eblood; se não achar, tenta de novo por código ISBT. |
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",
"status": "5",
"patient": {
"id": 11024,
"name": "MARIA DA SILVA SANTOS",
"birthdate": "1980-05-10",
"formatted_age": "46 anos",
"href": "/api/v1/patients/11024"
},
"hospital": {
"id": 1,
"name": "HOSPITAL EXEMPLO",
"cnpj": "12.345.678/0001-90",
"href": "/api/v1/hospitals/1"
},
"health_insurance": {
"id": 7,
"name": "CONVENIO EXEMPLO",
"default_for_sus": false,
"href": "/api/v1/health_insurances/7"
},
"requirer": {
"name": "DR. JOAO OLIVEIRA",
"crm": "123456",
"crm_uf": "SP",
"specialty_ans_code": "225140"
},
"transfusion_type": "3",
"hemoglobin": "8.5",
"hematocrit": "27.3",
"platelets": 180000,
"items": { "href": "/api/v1/requisitions/12345678901234/items" },
"procedures": { "href": "/api/v1/requisitions/12345678901234/procedures" },
"charging_items": { "href": "/api/v1/requisitions/12345678901234/charging_items" },
"materials": { "href": "/api/v1/requisitions/12345678901234/materials" }
}{
"message": "Hospital não encontrado no Eblood para o CD_ESTABELECIMENTO informado: 1",
"errors": ["Hospital não encontrado no Eblood para o CD_ESTABELECIMENTO informado: 1"]
}{
"message": "Physician name or crm não pode ser vazio",
"errors": ["Physician name or crm não pode ser vazio"]
}Atualizar status da requisição
Registra a etapa de execução/infusão reportada pelo sistema integrado no status administrativo/faturamento da requisição como um todo — não identifica nem afeta um hemocomponente específico. 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. Para atualizar o status de um hemocomponente específico dentro da requisição, veja o endpoint abaixo.
Valores aceitos
| Código | Significado |
|---|---|
| N | Aguardando |
| I | Iniciado |
| INT | Interrompido |
| T | Terminado |
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",
"errors": {}
}Atualizar status do hemocomponente (e sinais vitais)
Registra o status de um hemocomponente (bolsa) específico dentro de uma requisição, identificado pelo stock_item_id — diferente do status administrativo da requisição inteira (endpoint anterior). Os sinais vitais da transfusão são enviados no mesmo payload, opcionalmente.
Valores aceitos para status
| Código | Significado |
|---|---|
| 1 | Em análise (testing) |
| 2 | Liberado (released) |
| 3 | Rejeitado (rejected) |
| 4 | Esgotado/transfundido (depleted) |
| 5 | Descartado (discard) |
| 6 | Transferido (transferred) |
| 7 | Convertido (converted) |
| 8 | Enviado à indústria (sent_to_industry) |
| 9 | Reconstituído (reconstituted) |
Sinais vitais (opcional, no mesmo payload)
Além do status, o mesmo PUT aceita os campos abaixo para registrar uma aferição de sinais vitais do item — feita durante a transfusão. O grupo inteiro é opcional: se nenhum campo de sinais vitais for enviado, só o status é atualizado, normalmente. Mas assim que qualquer um deles for enviado — inclusive moment isoladamente — moment, temperature, systolic_pressure, diastolic_pressure, pulse e responsible passam todos a ser obrigatórios nessa chamada (só user_id continua opcional).
| Campo | Obrigatório | O que é |
|---|---|---|
| moment | Condicional | Momento da aferição — ver tabela de domínio. |
| temperature | Condicional | Temperatura corporal (°C). |
| systolic_pressure | Condicional | Pressão arterial sistólica. |
| diastolic_pressure | Condicional | Pressão arterial diastólica. |
| pulse | Condicional | Pulso (bpm). |
| responsible | Condicional | Nome do responsável pela aferição. |
| user_id | Não | Id do usuário Eblood responsável pela aferição, quando aplicável. Único campo do grupo que continua opcional. |
Se já houver uma aferição registrada para o mesmo moment nesse item, ela é substituída pelos novos valores em vez de criar uma duplicata — o sistema integrado sempre envia um dos 4 valores fixos de moment (início/10min/1h/final), nunca um horário livre. A data/hora da aferição gravada no Eblood é o momento em que o registro é processado (não um campo enviado no payload).
Se o status for válido mas os dados de sinais vitais forem inválidos (ou moment estiver faltando), nada é salvo — nem o status, nem a aferição. A chamada inteira falha com 400 e precisa ser reenviada corrigida.
Exemplo de chamada — só status
curl -X PUT "{{BASE_URL}}/api/v1/requisitions/12345678901234/items/987654/update_status" \
-H "Authorization: Token token=\"{{TOKEN}}\"" \
-d "status=2"
{
"status": "2"
}
Exemplo de chamada — status + sinais vitais juntos
curl -X PUT "{{BASE_URL}}/api/v1/requisitions/12345678901234/items/987654/update_status" \
-H "Authorization: Token token=\"{{TOKEN}}\"" \
-d '{
"status": "2",
"moment": "1",
"temperature": "36.5",
"systolic_pressure": 120,
"diastolic_pressure": 80,
"pulse": 72,
"responsible": "Enfermeira Joana"
}'
{
"status": "2",
"moment": "1",
"temperature": "36.5",
"systolic_pressure": 120,
"diastolic_pressure": 80,
"pulse": 72,
"responsible": "Enfermeira Joana"
}
Respostas possíveis
{
"message": "Status successfully updated"
}{
"message": "Stock item 987654: The received status (Z) is invalid",
"errors": {}
}{
"message": "Vital signs could not be saved",
"errors": { "moment": ["não pode ser vazio"] }
}Esse formato (errors como objeto) é específico de moment ausente. Para os demais erros de validação dos sinais vitais (ex: pressão negativa), errors vem como lista de mensagens: ["Systolic pressure precisa ser maior do que 0"]. Em ambos os casos o status também não é atualizado — veja o aviso "Tudo ou nada" acima.
{
"message": "Resource could not be found"
}Retornado quando o stock_item_id informado não existe ou não pertence à requisição do requisition_id informado. É a resposta padrão do Eblood para qualquer recurso não encontrado, não é específica deste endpoint.
Consultar sinais vitais do item da requisição
Retorna as aferições de sinais vitais (temperatura, pressão, pulso) já registradas para um item específico da requisição, uma por moment. Para registrar uma aferição, use o campo de sinais vitais do endpoint de atualização de status do hemocomponente (seção 06) — o sistema integrado envia status e sinais vitais juntos, no mesmo PUT.
Este endpoint identifica o item pelo requisition_item_id — o item solicitado dentro da requisição — e não pelo stock_item_id (a bolsa física) usado no endpoint da seção 06. São ids de recursos diferentes; não é possível usar um no lugar do outro.
Exemplo de chamada
curl -X GET "{{BASE_URL}}/api/v1/requisitions/12345678901234/requisition_items/987654/vital_signs" \
-H "Authorization: Token token=\"{{TOKEN}}\""
[
{
"moment": "1",
"requisition_item_id": 987654,
"temperature": "36.5",
"systolic_pressure": 120,
"diastolic_pressure": 80,
"pulse": 72,
"user_id": null,
"responsible": "Enfermeira Joana"
}
]
Consultar requisição criada
Endpoint já existente no Eblood, útil para conferir — depois do POST de criação e dos PUTs de status — o estado final da requisição, incluindo o status atual. O campo items da resposta traz o link para a lista de hemocomponentes da requisição (seção 09), cada um com o seu próprio status.
Exemplo de chamada
curl -X GET "{{BASE_URL}}/api/v1/requisitions/12345678901234" \
-H "Authorization: Token token=\"{{TOKEN}}\""
Listar hemocomponentes da requisição
Retorna a lista de hemocomponentes (bolsas) vinculados à requisição, um por item. É aqui que se obtém o stock_item_id usado no PUT de status do hemocomponente (seção 06) e o requisition_item_id usado no GET de sinais vitais (seção 07).
Quando vários hemocomponentes físicos formam um único pool (ex: pool de plaquetas), eles aparecem como um único item na lista, com stock_item.pool_quantity maior que 1 e stock_item.pool_isbt_codes listando os códigos ISBT de cada unidade física. Nesse caso, requisition_item_id corresponde apenas ao primeiro item físico do pool — os demais não aparecem individualmente nesta lista.
Exemplo de chamada
curl -X GET "{{BASE_URL}}/api/v1/requisitions/12345678901234/items" \
-H "Authorization: Token token=\"{{TOKEN}}\""
[
{
"requisition_item_id": 987654,
"included_at": "2026-08-18T10:05:00-03:00",
"stock_item": {
"id": 987654,
"isbt_code": "W123450000012",
"hemocomponent_id": 3,
"hemocomponent_category": "1",
"hemocomponent_description": "Concentrado de Hemácias",
"equivalent_quantity": 1.0
},
"transfused_quantity": 1,
"transfused": false,
"reserved": true,
"charge_reservation": false,
"should_bill": true,
"status": "1",
"sent_at": null,
"confirmed_at": null
}
]
stock_item.id é o stock_item_id usado na seção 06. requisition_item_id (no nível raiz do item, fora de stock_item) é o id usado na seção 07 — são dois ids diferentes, mesmo quando coincidem numericamente neste exemplo.
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).
IE_ESTADO_CIVIL Estado civil · traduzido para o padrão do Eblood
| Código de origem | Descrição de origem | Código Eblood | Descrição Eblood |
|---|---|---|---|
| 1 | Solteiro | 1 | Solteiro |
| 2 | Casado | 2 | Casado |
| 3 | Divorciado | 4 | Divorciado |
| 4 | Desquitado | 4 | Divorciado (aproximação) |
| 5 | Viúvo | 3 | Viúvo |
| 6 | Separado | 5 | Separado |
| 7 | Concubinato/União Estável | 6 | União Estável |
| 9 | Outros | 7 | Não Informado |
| 10 | Desconhecido | 7 | Não Informado |
IE_GRAU_INSTRUCAO Grau de instrução · traduzido para o padrão do Eblood
| Código de origem | Descrição de origem | Código Eblood | Descrição Eblood |
|---|---|---|---|
| 1 | Analfabeto | 1 | Não Cursou |
| 2 | Fundamental Completo | 3 | 1º Grau Completo |
| 3 | Médio Completo | 5 | 2º Completo |
| 4 | Superior | 7 | 3º Grau Completo |
| 5 / 18 | Mestrado | 11 | Mestrado |
| 6 / 17 | Doutor / Doutorado | 12 | Doutorado |
| 7 | Fundamental Incompleto | 2 | 1º Grau Incompleto |
| 8 | Médio Incompleto | 4 | 2º Incompleto |
| 9 | Superior Incompleto | 6 | 3º Grau Incompleto |
| 10 | Primário | 2 | 1º Grau Incompleto (aproximação) |
| 11 | Não Alfabetizado | 1 | Não Cursou |
| 12 / 19 | Pós-graduação | 10 | Pós-graduação |
| 13 | Ph.D. | 12 | Doutorado (tratado como sinônimo) |
| 14 | Não informado pela pessoa | 8 | Não Informado |
| 15 | Nível Técnico Completo | 9 | Técnico Completo |
| 16 | Pós-doutorado | 13 | Pós-doutorado |
| 20 | Superior completo | 7 | 3º Grau Completo |
CD_NACIONALIDADE Nacionalidade · 86 valores, sem tradução
Código idêntico ao da especificação original do sistema integrado, sem tradução.
| Código | Descrição |
|---|---|
| 10 | Brasileira |
| 14 | Venezuelana |
| 15 | Colombiana |
| 16 | Peruana |
| 17 | Equatoriana |
| 18 | Surinamesa |
| 19 | Guianense |
| 20 | Naturalizado Brasileiro |
| 21 | Argentina |
| 22 | Boliviana |
| 23 | Chilena |
| 24 | Paraguaia |
| 25 | Uruguaia |
| 30 | Alemã |
| 31 | Belga |
| 32 | Britânica |
| 34 | Canadense |
| 35 | Espanhola |
| 36 | Norte Americana (USA) |
| 37 | Francesa |
| 38 | Suíça |
| 39 | Italiana |
| 41 | Japonesa |
| 42 | Chinesa |
| 43 | Coreana |
| 45 | Portuguesa |
| 48 | Outras Latino-Americanas |
| 49 | Outras Asiáticas |
| 50 | Outras |
| 51 | Mexicana |
| 52 | Africana |
| 53 | Albanesa |
| 54 | Angolana |
| 55 | Árabe |
| 56 | Argelina |
| 57 | Australiana |
| 58 | Austríaca |
| 59 | Búlgara |
| 60 | Cabo-verdiana |
| 61 | Croata |
| 62 | Cubana |
| 63 | Curda |
| 64 | Dinamarquesa |
| 65 | Egípcia |
| 66 | Escocesa |
| 67 | Finlandesa |
| 68 | Galesa |
| 69 | Grega |
| 70 | Holandesa |
| 71 | Húngara |
| 72 | Indiana |
| 73 | Inglesa |
| 74 | Iraniana |
| 75 | Iraquiana |
| 76 | Irlandesa |
| 77 | Islandesa |
| 78 | Israelense |
| 79 | Jamaicana |
| 80 | Judeu |
| 81 | Libanesa |
| 82 | Lituana |
| 83 | Moçambicana |
| 84 | Neozelandesa |
| 85 | Nepalesa |
| 86 | Nigeriana |
| 87 | Norueguesa |
| 88 | Persa |
| 89 | Polonesa |
| 90 | Porto-riquenha |
| 91 | Romana |
| 92 | Romena |
| 93 | Russa |
| 94 | Saudita |
| 95 | Sérvia |
| 96 | Síria |
| 97 | Sueca |
| 98 | Sul-africana |
| 99 | Tcheca |
| 100 | Tibetana |
| 101 | Turca |
| 102 | Ucraniana |
| 103 | Vietnamita |
| 105 | Desconhecida |
| 106 | Guatemalteca |
| 107 | Filipinas |
| 108 | Barbadiano |
IE_TIPO Tipo de transfusão · traduzido para o padrão do Eblood
| Código de origem | Descrição de origem | Código Eblood | Descrição Eblood |
|---|---|---|---|
| 1 | Programada (dia e hora marcados) | 1 | Programada |
| 2 | De rotina (até 24h) | 8 | De rotina - em até 24 horas |
| 3 | Urgente (até 3h) | 3 | De urgência - em até 3 horas |
| 4 | Emergência (risco de vida) | 4 | De emergência - sob termo de responsabilidade |
Quando IE_RESERVA é S, este campo é ignorado e o tipo vira "Reserva" automaticamente.
IE_PORTE_CIRURGICO Porte da cirurgia
| Código | Significado |
|---|---|
| P | Pequeno |
| M | Médio |
| G | Grande |
| NP | Não previsível |
NR_SEQ_REACAO Tipo de reação transfusional prévia
| Código | Significado |
|---|---|
| 1 | Reação febril não hemolítica |
| 2 | Reação hemolítica |
| 3 | Reação alérgica |
| 4 | Reação anafilática/anafilactóide |
| 5 | TRALI |
| 6 | Sobrecarga circulatória |
| 7 | Contaminação bacteriana |
| 8 | Reação atípica associada a inibidor de ECA |
| 9 | Embolia aérea |
| 10 | Hipocalcemia |
| 11 | Hipotermia |
| 12 | Aloimunização |
| 13 | Aloimunização HLA |
| 14 | Reação Enxerto Versus Hospedeiro |
| 15 | Púrpura pós-transfusional |
IE_GRAVIDEZ Histórico de gravidez
| Código | Significado |
|---|---|
| S | Sim |
| N | Não |
| I | Ignorado |
| X | Não sabe |
IE_STATUS Status da requisição · usado no PUT de atualizar status da requisição (seção 05)
| Código | Significado |
|---|---|
| N | Aguardando |
| I | Iniciado |
| INT | Interrompido — cobre também a suspensão da requisição |
| T | Terminado |
Status do hemocomponente Códigos nativos do Eblood · usado no PUT de atualizar status do hemocomponente (seção 06)
Este endpoint não traduz os códigos do sistema integrado — os valores aceitos são os códigos nativos do hemocomponente no Eblood:
| Código | Significado |
|---|---|
| 1 | Em análise (testing) |
| 2 | Liberado (released) |
| 3 | Rejeitado (rejected) |
| 4 | Esgotado/transfundido (depleted) |
| 5 | Descartado (discard) |
| 6 | Transferido (transferred) |
| 7 | Convertido (converted) |
| 8 | Enviado à indústria (sent_to_industry) |
| 9 | Reconstituído (reconstituted) |
moment Momento da aferição · usado nos sinais vitais do PUT de status do hemocomponente (seção 06)
| Código | Significado |
|---|---|
| 1 | Início da transfusão |
| 2 | 10 minutos após o início |
| 3 | 1 hora após o início |
| 4 | Final da transfusão |
NR_SEQ_COR_PELE Cor/raça · traduzido para o padrão do Eblood
| Código de origem | Descrição de origem | Código Eblood | Descrição Eblood |
|---|---|---|---|
| 1 | Branca | 1 | Branca |
| 2 | Negra | 2 | Negra |
| 4 | Amarela | 3 | Amarela |
| 11 | Parda | 4 | Parda |
| 13 | Vermelha | 5 | Indígena (aproximação) |
| 21 | Desconhecida | 7 | Não Informado |
CD_RELIGIAO Religião · sem tradução, mesmo código do sistema integrado
| Código | Descrição |
|---|---|
| 2 | Católica |
| 3 | Testemunha de Jeová |
| 11 | Espiritualista |
| 17 | Não possui Religião |
| 21 | Evangélica |
| 23 | Outras |
| 24 | Budista |
| 25 | Hinduísta |
| 26 | Islâmica |
| 27 | Judaica |
| 28 | Desconhecida |
| 29 | Prefiro não informar |
| 31 | Israelita |
| 32 | Muçulmana |
| 33 | Protestante |
| 34 | Ortodoxa |
| 35 | Espírita |
| 36 | Mormon |
| 37 | Agnóstico |
| 38 | Adventista |
| 39 | Perfeita Liberdade |
| 40 | Cristã |
| 41 | Umbanda |
| 42 | Candomblé |
| 43 | Metodista |
| 44 | Maçom |
| 45 | Xintoista |
| 46 | Oomoto |
| 47 | Batista |
| 48 | Messiânica |
| 49 | Luterana |
| 50 | Cabala |
| 51 | Doutrinas |
| 52 | Seicho No Ie |
| 53 | Divinismo |
| 54 | Ateísmo |
| 55 | Religião de Deus |
IE_TIPO_PACIENTE Tipo de paciente · traduzido para o padrão do Eblood
| Código de origem | Descrição de origem | Código Eblood |
|---|---|---|
| C | Clínico | 6 — clinical |
| I | Cirúrgico | 7 — cirurgical |
Erros comuns
Guia rápido para entender o que cada código de resposta quer dizer e o que fazer a respeito.
| Código | O que significa | O que fazer |
|---|---|---|
| 201 | Requisição criada com sucesso. | Guarde o id retornado — ele é o mesmo NR_PRESCRICAO enviado. |
| 200 | Status atualizado com sucesso. | Nada a fazer — a atualização foi registrada. |
| 422 | O hospital (CD_ESTABELECIMENTO) não foi encontrado no Eblood. | Confirme se o hospital já está cadastrado no Eblood com esse código antes de reenviar. |
| 422 | O médico (CD_MEDICO) não foi encontrado e não foi possível cadastrá-lo automaticamente. | Envie NM_MEDICO, UF_MEDICO e um CD_ESPECIALIDADE válido — são obrigatórios para criar o médico quando o CRM ainda não existe no Eblood. |
| 422 | DS_CONVENIO veio vazio ("Health insurance name não pode ser vazio"). | Hoje toda requisição assume cobrança por convênio — envie DS_CONVENIO sempre, mesmo que precise criar um convênio novo no Eblood. |
| 422 | Outro erro de validação (ex: NR_PRESCRICAO duplicado ou fora do tamanho 6-14, item de DS_ITEM_REQ inválido). | Confira o campo errors da resposta. |
| 400 | O código de status enviado no PUT de status da requisição é inválido. | Use apenas N, I, INT ou T. |
| 400 | O código de status enviado no PUT de status do hemocomponente é inválido. | Use um dos códigos nativos listados na seção 06 — este endpoint não traduz os códigos do sistema integrado. |
| 404 | O stock_item_id informado no PUT de status do hemocomponente não existe ou não pertence à requisição. | Confira se o id usado é o mesmo retornado em stock_item.id na seção 09 (listar hemocomponentes). |
| 400 | Dados de sinais vitais inválidos no PUT de status do hemocomponente (ex: moment ausente, pressão negativa). | Confira o campo errors da resposta. Nesse caso o status também não é atualizado — veja "Tudo ou nada" na seção 06. |