Demonstrativo pagamento:Produção do Demonstrativo de Pagamento

Índice

Só são suportadas integrações no padrão REST.

Orientações

Parâmetros de entrada

Serão enviados no HEADER os headers estáticos definidos ao configurar a integração, combinado com os tokens retornados pela configuração de autorização da integração (caso seja vinculada) e os headers de segurança retornado no login do beneficiário.

Critérios de preenchimento

Abreviação	Nome	Descrição
M	Mandatório	O preenchimento do atributo é obrigatório. Caso o atributo esteja nulo ou em branco, seu "response" será rejeitado.
C	Condicional	O atributo pode tornar-se obrigatório quando um ou mais atributos auxiliares for preenchido / atualizado.
OP	Opcional	Seu preenchimento não é obrigatório. Pode-se enviar NULL para objetos, ou arrays vazios para tipos Array

Objetos e atributos de retorno

Os atributos devem seguir exatamente os mesmos nomes indicados nesta documentação, caso contrário, serão rejeitados pelo validador de integração.

Exemplo do atributo “contratos”:

~~Contrato~~
~~contrato~~
~~Contratos~~
contratos

Método de detalheDebito

Atente-se as orientações fornecidas pela Mobile Saúde;
Atente-se aos critérios de preenchimento;
Atente-se aos critérios de objetos e atributos de retorno;
Atente-se as mensagens de retorno para cada HTTPS Status Code;

Endpoint

Endpoint	Método	Header Content-Type	Descrição
http://exemplo.com/ demonstrativoPagamento/producao	POST	application/json	Retorna uma lista detalhada dos procedimentos executados pelo cooperado no período selecionado

Parâmetros de entrada

Parâmetro	Obrigatório	Tipo	Descrição
chavePagamento	M	String	Chave de identificação do período selecionado. Essa informação é retornada pelo método listaPeriodo.
chaveUnica	M	String	Chave de identificação do usuário retornada no login
integracao	OP	Objeto	Nó integração retornado no login do usuário

Exemplo request

url: 
https://www.operadoradesaude.com.br/mobilesaude/demonstrativoPagamento/producao

Body:
{
	"chaveUnica" : "101012",                
	"integracao": {
    	"xpto": "voluptatibus",
        "xyz": "quibusdam",
        "abcdef": 9288701
    },
    "chavePagamento": "MS00579",  
}

Descrição dos objetos e atributos de retorno - Sucesso

Está indicado abaixo a estrutura de retorno do seu método login. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.

Objeto principal

Atributo	Critério	Tipo	Descrição	Regra de preenchimento
descricao	M	String	Informe o texto de apresentação do período de pagamento, por exemplo: “Primeira quinzena“; “Segunda quinzena“; “Pagamento mensal”
tituloTotalizador	M	String	titulo totalizador dos registros de produção	texto livre
valorTotal	M	Float	valor total liquido a receber
dataPagamento	M	String	Data de Pagamento	Formato: Formato: YYYY-MM-DD
producao	M	Number	Array de objetos “producao”
alerta	OP	Object	Objeto do tipo "alerta"	Informativo a ser exibido no card de alerta da tela. Consulte o layout.

Objeto producao

Atributo	Critério	Tipo	Descrição	Regra de preenchimento
procedimento	M	Objeto	Objeto do tipo "procedimento" segue a baixo na documentacao
beneficiario	M	objeto	Objeto do tipo "beneficiario" segue a baixo na documentacao
servico	M	objeto	Objeto do tipo "servico" segue a baixo na documentacao
numeroGuia	M	String	Número da guia no seu sistema de gestão
numeroAutorizacao	M	String	Número da autorização.
numeroProtocolo	M	String	Número do protocolo (PEG).
tipoContrato	M	String	Tipo de contrato	Exemplo: Custo Operacional Intercambio Pre-Pagamento
quantidadeCh	M	Number	Quantidade de CH do procedimento.	Se não houver, enviar zero
valorCh	M	Float	Valor do CH.	Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) Se não houver, enviar zero
coparticipacaoNoAto	M	Float	Valor da coparticipação paga no ato em consultório.	Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) Se não houver, enviar zero
regimeAtendimen to	M	String	Regime de atendimento	por exemplo: Consultório Internação PCMSO SP/SADT
naoConformidade	OP	String	Descrição da não conformidade
localExecucao	OP	String	Descrição do local de execução	Formato: Texto livre

Objeto alerta

Atributo	Critério	Tipo	Descrição	Regra de preenchimento
icone	OP	String	icone a ser utilizado no card de alerta. Verifique a lista de icones disponiveis pela mobile.
mensagem	M	String	Informe a mensagem a ser exibida no card de alerta. Consulte o layout	texto livre
cor	M	String	cor da label a ser exibida.	Hexadecimal. com o #. da cor que deseja que seja usada para representar a situação do débito. Ex.: `#FF0000`

Objeto procedimento

Atributo	Critério	Tipo	Descrição	Regra de preenchimento
codigo	M	String	Código do procedimento
descricao	M	String	Descrição do procedimento	Texto livre

Objeto beneficiario

Atributo	Critério	Tipo	Descrição
nome	M	String	Nome do beneficiario
matricula	M	String	Numero da matricula do beneficiario
plano	M	String	Descrição do plano do beneficiário

Objeto servico

Atributo	Critério	Tipo	Descrição	Regra de preenchimento
descricao	M	String	Tipo de serviço	exemplo: Consulta Exames Honorário Médico
data	M	String	Data da execução do serviço
quantidade	M	Number	Quantidade executada
valor	M	Float	Valor total do serviço executado.	Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) Se não houver, informar zero

Exemplo retorno API - sucesso

{
  "descricao": "Pagamento Mensal",
  "tituloTotalizador": "Total de produção",
  "valorTotal": 1257.99,
  "dataPagamento": "2024-08-01",
  "producao": [
    {
      "procedimento": {
        "codigo": "10101012",
        "descricao": "Consulta em consultorio"
      },
      "beneficiario": {
        "nome": "Fabio Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020003",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020001",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020002",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020004",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020005",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020006",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020007",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020008",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020009",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020010",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    },
    {
      "procedimento": {
        "codigo": "10101013",
        "descricao": "Cesariana (COM DIRETRIZ DE ENFERMAGEM)"
      },
      "beneficiario": {
        "nome": "Kemilly Neves",
        "matricula": "00010001000001000"
      },
      "servico": {
        "descricao": "Consulta",
        "data": "2024-08-01",
        "quantidade": 1,
        "valor": 1000
      },
      "numeroGuia": "000100020011",
      "numeroAutorizacao": "01010101",
      "numeroProtocolo": "01010101",
      "tipoContrato": "Intercambio",
      "plano": "PP/CRUP",
      "quantidadeCh": 100,
      "valorCh": 0.8,
      "coparticipacaoNoAto": 20,
      "regimeAtendimento": "internacao",
      "naoConformidade": "descrição da não conformidade",
      "localExecucao": "Consultorio"
    }
  ],
  "alerta": {
    "icone": "icon_boleto_calendar",
    "cor": "#FF0000",
    "mensagem": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
  }
}

Descrição dos objetos e atributos de retorno - falha

Está indicado abaixo a estrutura de retorno do seu método listaDebitos. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.
Atente-se as mensagens de retorno para cada HTTPS Status Code;

Objetos e atributos de retorno

Atributo	Critério	Tipo	Descrição	Regra de preenchimento
mensagem	M	String	mensagem para ser exibida para o cliente	texto livre

Exemplo retorno API - falha

{
  "mensagem": "Não foi possível obter os detalhes deste débito. Por favor, entre em contato com suporte."
}

Ícones disponíveis (.png)

icon_boleto_calendar	icon_boleto_card	icon_boleto_check
icon_boleto_exclamation	Icon_boleto_exclude	icon_boleto_money
icon_boleto_notification	icon_boleto_star

Demonstrativo pagamento:Produção do Demonstrativo de Pagamento

[data-colorid=yjda1no3x2]{color:#36b37e} html[data-color-mode=dark] [data-colorid=yjda1no3x2]{color:#4cc994}Índice

Orientações

Parâmetros de entrada

Critérios de preenchimento

Objetos e atributos de retorno

Método de detalheDebito

Endpoint

Parâmetros de entrada

Exemplo request

Descrição dos objetos e atributos de retorno - Sucesso

Exemplo retorno API - sucesso

Descrição dos objetos e atributos de retorno - falha

Exemplo retorno API - falha

Ícones disponíveis (.png)

Índice