Ogmma Revenue

Faturamento

GET/v1/lotes-importados/{id}/guias

As guias do lote, com os itens de cada uma

SP/SADT e Consulta na mesma lista, distinguidas por tipo: quem pergunta "o que eu mandei neste lote" não quer duas respostas para juntar. Consulta vem com itens: [] — a consulta É o procedimento.

Escopo:
lote:ler
Resposta:
200

Pedido

Caminho

{id}*Identificador do recurso no Miydas. Opaco e estável — NÃO é o número que a operadora ou o seu sistema usam para a mesma coisa. Guarde-o como veio e não derive significado do formato.

Exemplo de chamada

curl -X GET https://api.miydas.com.br/v1/lotes-importados/cmf3k2x9a0001aut/guias \
  -H "Authorization: Bearer $MIYDAS_CHAVE"

Resposta 200

dataGuiasDoLoteO recurso. Os campos estão na tabela abaixo.

As guias do lote com os itens de cada uma — SP/SADT e Consulta na mesma lista, distinguidas por tipo.

Campos de GuiasDoLote

CampoTipoO que é
loteIdtextoO lote a que esta guia pertence, pelo identificador do Miydas.
numeroLotetextoO número do lote, como ele foi transmitido à operadora.
guiaslista de objetosAs guias do documento.
tipotexto
um de: SP_SADT, CONSULTA
O tipo da guia TISS. CONSULTA não tem itens: a consulta é o próprio procedimento.
numeroGuiaPrestadortextoO número que VOCÊ deu à guia. O TISS não deixa repetir dentro do prestador, e é por ele que você reencontra a guia aqui.
numeroGuiaOperadoratextoO número que a OPERADORA deu à guia. Só existe depois que ela respondeu, e é o número que vale numa discussão com ela.
senhatextoA senha de autorização que a operadora concedeu. É ela que autoriza a execução.
autorizadaEmtextoQuando a operadora autorizou, em ISO 8601 com fuso.
carteiratextoNúmero da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador.
beneficiariotextoO nome do beneficiário, como a operadora o devolveu. Pode divergir do seu cadastro, e em boa parte dos documentos nem vem — a carteirinha é que identifica.
cobradotextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
itenslista de objetosVazio em CONSULTA: a consulta É o procedimento, e não tem item.
sequencialinteiroA ordem do registro dentro do documento, como a operadora a numerou.
tipotextoNatureza da linha: PROCEDIMENTO ou DESPESA (material, medicamento, taxa).
tabelatextoQual tabela o código usa (22 = TUSS procedimentos, 00 = tabela própria da operadora). Padrão 22.
codigotextoCódigo do item na tabela declarada.
descricaotextoDescrição do item, como a fonte a informou.
quantidadetextoQuantas unidades, como o documento declarou. Vem em texto porque a operadora às vezes manda fracionado (1,5) e arredondar aqui mudaria o valor da conta.
valorUnitariotextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
cobradotextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
executadoEmtextoQuando a execução ocorreu, em ISO 8601 com fuso.
atendidaEmtextoData do atendimento declarada no documento.

Exemplo de retorno

{
  "data": {
    "loteId": "cmf3k2x9a0001lti",
    "numeroLote": "2026070112",
    "guias": [
      {
        "tipo": "SP_SADT",
        "numeroGuiaPrestador": "000123",
        "numeroGuiaOperadora": "18700001",
        "senha": "18700001",
        "autorizadaEm": "2026-06-28",
        "carteira": "00000000000000000",
        "beneficiario": "PACIENTE EXEMPLO",
        "cobrado": "226.29",
        "itens": [
          {
            "sequencial": 1,
            "tipo": "PROCEDIMENTO",
            "tabela": "22",
            "codigo": "40301591",
            "descricao": "COLESTEROL LDL",
            "quantidade": "1",
            "valorUnitario": "8.94",
            "cobrado": "8.94",
            "executadoEm": "2026-07-02"
          }
        ],
        "atendidaEm": null
      }
    ]
  }
}

Experimente sem chave

O sandbox devolve este mesmo corpo, sem autenticação e sem tocar na base de ninguém.

curl https://api.miydas.com.br/v1/sandbox/lotes_importados_guias

A chave de teste myd_test_… é outra coisa: ela opera na homologação da operadora e serve para escrever. Para ver o formato antes de ter credencial, convênio e varredura, é este sandbox.

Erros

CódigoHTTPQuandoO que fazer
RECURSO_NAO_ENCONTRADO404O id não existe — ou é de outra empresa, o que a API não distingue de propósito. Também a rota inexistente na v1.Confira o id.

Toda falha tem o mesmo formato: { "error": "CODIGO", "message": "…", "details": { … } }. error é estável e serve para lógica; message é para gente e pode mudar. Erros comuns a toda rota com chave (lista completa) não se repetem aqui.