CONTEÚDO
- Visão Geral
- Exemplo de utilização
- companies
- contracts
- subcontracts
- Tela api companies
- Outras Ações / Ações relacionadas
- Tela api companies
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
API para a entidade companies (Empresas) do produto TOTVS Saúde Planos Linha Protheus.
Clique aqui para detalhes sobre como habilitar o serviço de APIs
02. EXEMPLO DE UTILIZAÇÃO
Painel |
---|
Retorna o Cadastro de EmpresasRetorna as empresas cadastradas da operadora informada. /totvsHealthPlans/familyContract/v1/companies | |
Expandir |
---|
| Authorization (header) | | Cabeçalho usado para autorização das requisições | *required | Content-Type (header) | | 'application/json' é o formato do conteúdo | *required | health-insurer-code (query) | string | Paginação da Coleção | *required | login-user (query) | string | Paginação da Coleção |
| group-type (query) | string | Paginação da Coleção |
| page (query) | | Paginação da Coleção |
| pageSize (query) | | Quantidade de Itens por Página |
| order (query) | | Ordenação da Coleção |
| fields (query) | | Filtro de campos dos registros |
| filter (query) | | Indica o filtro querystring recebido (pode se utilizar um filtro oData) |
|
|
Expandir |
---|
| Body
Não possui body!
|
Expandir |
---|
title | (200) - OPERAÇÃO REALIZADA COM SUCESSO |
---|
| hasNext | boolean | Indica se ainda existem registros a serem retornados |
|
| remainingRecords | integer | Quantidade de registros ainda existem para retorno |
|
| items | array | Lista de empresas retornadas |
|
| items.company-code | string | Código | BG9_CODIGO | *required | items.description | string | Descrição | BG9_DESCRI | *required | items.group-type | string | Tipo de grupo (Pessoa física ou jurídica) | BG9_TIPO | *required | items.use | string | Uso | BG9_USO | *required | items.links | array | links relacionados ao recurso companies (Padrão HATEOAS) |
|
|
Bloco de código |
---|
language | c# |
---|
theme | Midnight |
---|
title | Exemplo |
---|
linenumbers | true |
---|
| {
"items": [
{
"company-code": "0001",
"description": "CONTRATOS PESSOA FISICA",
"group-type": "1",
"use": "1"
},
{
"company-code": "0002",
"description": "CONTRATOS PESSOA JURIDICA",
"group-type": "2",
"use": "1",
"links": [
{
"rel": "contracts",
"href": "/totvsHealthPlans/familyContract/v1/companies/0002/contracts?health-insurer-code=0001"
}
]
}
],
"hasNext": false,
"remainingRecords": 0
} |
|
Expandir |
---|
title | (406) - PARÂMETROS OBRIGATÓRIOS |
---|
| code | string | Código identificador do erro. | *required | message | string | Literal no idioma da requisição descrevendo o erro para o usuário. | *required | detailedMessage | string | Mensagem técnica e mais detalhada do erro. | *required | details | array | Lista de objetos de erro (recursiva) com mais detalhes sobre o erro principal. |
|
Bloco de código |
---|
language | c# |
---|
theme | Midnight |
---|
title | Exemplo |
---|
linenumbers | true |
---|
| {
"code": "E001",
"message": "Existem chaves obrigatórias que não foram informadas.",
"detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
"details": [
{
"code": "E001-406",
"message": "Chave health-insurer-code obrigatória",
"detailedMessage": "Não foi informado no queryParams da requisição a chave health-insurer-code."
}
]
} |
|
|
03. TELA API COMPANIES
Outras Ações / Ações relacionadas
Ação | Descrição |
---|
Não se aplica | Não se aplica |
04. TELA API COMPANIES
Principais Campos e Parâmetros
05. TABELAS UTILIZADAS