API - Autorizacao - Arvo

Recepciona as autorizações de contas médicas.

A autenticação é feita através de HMAC da seguinte forma:

A Arvo fornece uma API Key (chave pública) e um Secret Key chave privada

O cliente deve passar no request 3 headers:
a. X-API-Key - deve ser a API Key fornecida
b. X-Timestamp - UNIX timestamp do momento em que a requisição é disparada
c. X-Signature - base64 encoded de HMAC (usando sha256) bytes[API Key + timestamp + identificadorEnvio]

No servidor, iremos assinar a requisição de forma análoga e verificar se o timestamp está no intervalo de 10 minutos (caso tenha passado, a autenticação irá falhar)

Requisição

Parâmetros Bodyapplication/json

Exemplo

{
    "dadosEnvio": {
        "identificadorEnvio": "labore aliquip ex velit",
        "nomeOperadora": "culpa sint"
    },
    "autorizacoes": [
        {
            "dadosGuia": null,
            "dadosAutorizacao": {
                "senhaAutorizacao": "250798",
                "autorizacaoPrincipal": "250798",
                "statusAutorizacao": "CONCLUIDO",
                "tipoFinalizacao": "AUTOMATICA",
                "dataSolicitacao": "2025-07-13T09:00:00Z",
                "dataEmissao": "2025-07-14T10:00:00Z",
                "dataValidade": "2025-08-14T10:00:00Z"
            },
            "dadosAtendimento": {
                "caraterAtendimento": "ELETIVO"
            },
            "dadosBeneficiario": {
                "identificador": "qui fugiat officia Duis amet"
            },
            "dadosExecutante": {
                "identificador": "enim et officia"
            },
            "itens": [
                {
                    "identificadorItem": "aliquip",
                    "codigoTabela": "TUNEP",
                    "codigo": "aute",
                    "descricao": "ut id esse magna pariatur",
                    "categoria": "MEDICAMENTO",
                    "quantidadeSolicitada": 1868815.9632719154,
                    "quantidadeAutorizada": null,
                    "valorSolicitado": 988465.3341410978,
                    "valorAutorizado": null,
                    "tipoNegativa": "nulla laborum minim eiusmod est"
                },
                {
                    "identificadorItem": "enim velit esse",
                    "codigoTabela": "SIMPRO",
                    "codigo": "occaecat qui in",
                    "descricao": "pariatur dolor id",
                    "categoria": "DIARIA",
                    "quantidadeSolicitada": 95198471.25085616,
                    "quantidadeAutorizada": null,
                    "valorSolicitado": 21091933.584611505,
                    "valorAutorizado": null,
                    "tipoNegativa": null
                },
                {
                    "identificadorItem": "Ut pariatur ut quis",
                    "codigoTabela": "TNUMM",
                    "codigo": "ex voluptate consectetur ut et",
                    "descricao": "aute",
                    "categoria": "CONSULTA",
                    "quantidadeSolicitada": 20919419.08277066,
                    "quantidadeAutorizada": 54613854.21733396,
                    "valorSolicitado": 96967557.50790116,
                    "valorAutorizado": null,
                    "tipoNegativa": "aliqua reprehenderit"
                }
            ]
        }
    ]
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/authorization' \
--header 'Content-Type: application/json' \
--data '{
    "dadosEnvio": {
        "identificadorEnvio": "labore aliquip ex velit",
        "nomeOperadora": "culpa sint"
    },
    "autorizacoes": [
        {
            "dadosGuia": null,
            "dadosAutorizacao": {
                "senhaAutorizacao": "250798",
                "autorizacaoPrincipal": "250798",
                "statusAutorizacao": "CONCLUIDO",
                "tipoFinalizacao": "AUTOMATICA",
                "dataSolicitacao": "2025-07-13T09:00:00Z",
                "dataEmissao": "2025-07-14T10:00:00Z",
                "dataValidade": "2025-08-14T10:00:00Z"
            },
            "dadosAtendimento": {
                "caraterAtendimento": "ELETIVO"
            },
            "dadosBeneficiario": {
                "identificador": "qui fugiat officia Duis amet"
            },
            "dadosExecutante": {
                "identificador": "enim et officia"
            },
            "itens": [
                {
                    "identificadorItem": "aliquip",
                    "codigoTabela": "TUNEP",
                    "codigo": "aute",
                    "descricao": "ut id esse magna pariatur",
                    "categoria": "MEDICAMENTO",
                    "quantidadeSolicitada": 1868815.9632719154,
                    "quantidadeAutorizada": null,
                    "valorSolicitado": 988465.3341410978,
                    "valorAutorizado": null,
                    "tipoNegativa": "nulla laborum minim eiusmod est"
                },
                {
                    "identificadorItem": "enim velit esse",
                    "codigoTabela": "SIMPRO",
                    "codigo": "occaecat qui in",
                    "descricao": "pariatur dolor id",
                    "categoria": "DIARIA",
                    "quantidadeSolicitada": 95198471.25085616,
                    "quantidadeAutorizada": null,
                    "valorSolicitado": 21091933.584611505,
                    "valorAutorizado": null,
                    "tipoNegativa": null
                },
                {
                    "identificadorItem": "Ut pariatur ut quis",
                    "codigoTabela": "TNUMM",
                    "codigo": "ex voluptate consectetur ut et",
                    "descricao": "aute",
                    "categoria": "CONSULTA",
                    "quantidadeSolicitada": 20919419.08277066,
                    "quantidadeAutorizada": 54613854.21733396,
                    "valorSolicitado": 96967557.50790116,
                    "valorAutorizado": null,
                    "tipoNegativa": "aliqua reprehenderit"
                }
            ]
        }
    ]
}'

API - Autorizacao

Requisição

Códigos de solicitação

Respostas