API CoopanestGO

Introdução

Esta API permite a consulta de dados de pagamentos, status e comprovantes de anestesia da CoopanestGO. Todas as operações são protegidas por autenticação e filtradas conforme as permissões do usuário.

• Tecnologia: .NET, JWT/Claims, Entity Framework
• Formato de dados: JSON
• Base URL: https://api.coopanestgo.com.br

Autenticação

Todos os endpoints exigem autenticação via Basic Authentication:

• Header: Authorization: Basic {base64(username:password)}
• Header: Content-Type: application/json

Permissões e Claims

Exemplo de geração do header em JavaScript

// Exemplo em JavaScript
const username = "seu_usuario";
const password = "sua_senha";
const credentials = btoa(username + ":" + password);
const authHeader = "Basic " + credentials;
// Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

Exemplo de requisição com cURL

curl -X POST "https://api.coopanestgo.com.br/DataReturn/status" \
  -H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "CodigoGrupo": "GRP001"
    }
  ]'

Retorna dados completos dos comprovantes, incluindo procedimentos, glosas, recursos e histórico de pagamentos.

Request Body

[
  {
    "CodigoGrupo": "GRP001",
    "CodigoCoopanest": "12345"
  }
]

Response

[
  {
    "CodigoCoopanest": 12345,
    "CodigoGrupo": "GRP001",
    "NomePaciente": "João Silva",
    "CnpjConvenio": "12.345.678/0001-90",
    "TipoCooperado": "PJ",
    "CRM": "12345-SP",
    "IdGrupo": 1,
    "CodigoSubdivisao": 1,
    "CnpjHospital": "98.765.432/0001-12",
    "NomeFantasiaHospital": "Hospital ABC",
    "Status": {
      "Descricao": "Aprovado",
      "Codigo": 1
    },
    "DataProcedimento": "2024-12-01T00:00:00",
    "CnpjEmpresa": "11.222.333/0001-44",
    "CodigoBarras": "123456789",
    "NomeEmpresa": "COOPANEST",
    "NomeFantasiaConvenio": "Convenio XYZ",
    "Acomodacao": 1,
    "Procedimentos": [
      {
        "Codigo": "40401014",
        "Item": 1,
        "Tipo": "Anestesia",
        "ValorProcedimento": 500.00,
        "ValorFinal": 450.00,
        "DetalhesGlosa": {
          "Codigo": 1,
          "Descricao": "Glosa administrativo",
          "Status": "Em Análise",
          "Valor": 50.00
        },
        "Recursos": []
      }
    ],
    "Pagamentos": [
      {
        "DataRepasse": "2024-12-15T00:00:00",
        "Resumo": {
          "Comprovante": 450.00,
          "Recurso": 0.00
        },
        "DetalheComprovante": [
          {
            "Codigo": 40401014,
            "Item": 1,
            "ValorPago": 450.00
          }
        ],
        "DetalheRecurso": []
      }
    ]
  }
]

Regras de acesso

• Retorna apenas comprovantes dos grupos/IDs permitidos pelas claims do usuário.
• Filtra por grupos e/ou comprovantes informados.

Lista as datas de repasse disponíveis, ordenadas da mais recente para a mais antiga.

Response

[
  "2024-12-15",
  "2024-11-15",
  "2024-10-15"
]

Retorna códigos dos comprovantes pagos em uma data específica para grupos específicos.

Request Body

{
  "DataRepasse": "2024-12-15",
  "Grupos": [
    "1",
    "2",
    "3"
  ]
}

Response

[
  {
    "CodigoCoopanest": 12345,
    "CodigoGrupo": "GRP001"
  },
  {
    "CodigoCoopanest": 12346,
    "CodigoGrupo": "GRP002"
  }
]

Regras de acesso

• Retorna apenas comprovantes dos grupos permitidos.
• Cooperados bloqueados na data não aparecem.

Retorna resumo dos valores repassados por comprovante.

Request Body

[
  {
    "CodigoGrupo": "GRP001"
  }
]

Response

[
  {
    "CodigoCoopanest": 12345,
    "CodigoGrupo": "GRP001",
    "NomePaciente": "João Silva",
    "Status": {
      "Descricao": "Aprovado",
      "Codigo": 1
    },
    "ValoresRepassados": {
      "Comprovante": 450.00,
      "RecursoGlosa": 25.00
    }
  }
]

Retorna apenas o status atual dos comprovantes solicitados.

Request Body

[
  {
    "CodigoGrupo": "GRP001"
  }
]

Response

[
  {
    "CodigoCoopanest": 12345,
    "CodigoGrupo": "GRP001",
    "NomePaciente": "João Silva",
    "Status": {
      "Descricao": "Aprovado",
      "Codigo": 1
    },
    "Observacao": "Comprovante aprovado sem pendências"
  }
]

Modelos de Dados

DataReturnRequest

{
  "CodigoGrupo": "string",
  "CodigoCoopanest": "string"
}

PaymentReturnResult

{
  "CodigoCoopanest": 12345,
  "CodigoGrupo": "GRP001",
  "NomePaciente": "João Silva"
  // ... outros campos ...
}

DataReturnResult

{
  "CodigoCoopanest": 12345,
  "CodigoGrupo": "GRP001",
  "NomePaciente": "João Silva",
  "Status": {
    "Descricao": "Aprovado",
    "Codigo": 1
  },
  "ValoresRepassados": {
    "Comprovante": 450.00,
    "RecursoGlosa": 25.00
  }
}

DataReturnResultStatusOnly

{
  "CodigoCoopanest": 12345,
  "CodigoGrupo": "GRP001",
  "NomePaciente": "João Silva",
  "Status": {
    "Descricao": "Aprovado",
    "Codigo": 1
  },
  "Observacao": "Comprovante aprovado sem pendências"
}

PaymentGuidesResult

{
  "CodigoCoopanest": 12345,
  "CodigoGrupo": "GRP001"
}

🚨 Códigos de Resposta

Possíveis Erros de Autenticação

• Missing Authorization Header: Header Authorization não foi enviado
• Invalid Authorization Header: Formato do header Authorization está incorreto
• Invalid Username or Password: Credenciais incorretas ou usuário não encontrado
• Permissões insuficientes: Usuário não tem acesso aos grupos solicitados

Notas Técnicas

• Todos os endpoints filtram dados conforme as claims do usuário autenticado.
• Datas seguem o formato ISO 8601 (YYYY-MM-DDTHH:mm:ss).
• Valores monetários são retornados como decimais.
• Comprovantes excluídos não aparecem nas consultas.
• Cooperados bloqueados não aparecem em payment-guides.

📞 Suporte

Para dúvidas técnicas ou problemas de integração, entre em contato com a equipe de desenvolvimento da COOPANESTGO.