Ogmma Revenue

Faturamento

GET/v1/lotes-importados

Os lotes que o prestador importou — a camada de envio

NÃO É O MESMO QUE /v1/lotes. Aquele é o lote que esta API montou e transmitiu, e dele guardamos a mensagem TISS e os totais. Este é o lote que o prestador IMPORTOU: o XML que ele mandou à operadora pela própria conta. Medido, os dois não se cruzam por número de lote. Importa porque /v1/guias diz que a camada de envio está ausente em 40.746 das 40.760 guias — o portal devolve julgamento e não guarda o que o prestador mandou. As que TÊM envio vieram daqui.

Escopo:
lote:ler
Resposta:
200

Pedido

Esta rota não recebe parâmetro nenhum — só a chave.

Exemplo de chamada

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

Resposta 200

datalista de LoteImportadoO recurso. Os campos estão na tabela abaixo.
paginacaoPaginacaoOnde esta página está no total. Vem fora de data.

O lote que o prestador IMPORTOU — o XML que ele mandou à operadora. Não é o mesmo de /v1/lotes, que é o lote montado por esta API: os dois não se cruzam. É daqui que vem a camada de envio das guias.

Campos de LoteImportado

CampoTipoO que é
idtextoIdentificador 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.
numeroLotetextoO número do lote, como ele foi transmitido à operadora.
competenciatextoMês AAAA-MM da data de NEGÓCIO do documento, em UTC — crédito na retenção, protocolo na glosa. NUNCA a data de emissão: o portal renderiza o documento no download, então a emissão é o dia em que nós baixamos.
tipoGuiatextoTipo de guia TISS: SP_SADT, CONSULTA, RESUMO_INTERNACAO, HONORARIO.
versaoTisstextoVersão do padrão TISS do documento (ex. 4.01.00). Quem dita a versão é a operadora.
origemtextoIMPORTADO (veio de arquivo) | GERADO (montado aqui).
situacaotextoO estado do lote importado aqui dentro — se foi lido, validado e distribuído em guias.
protocolotextoO protocolo que a operadora devolveu ao receber. É o número que prova a entrega e por onde se consulta o andamento depois.
emitidoEmtextoData que o documento declara como de emissão. Cuidado: em documento de portal, é o dia do download.
transmitidoEmtextoQuando o lote foi transmitido à operadora, em ISO 8601 com fuso.
valorTotaltextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
conformidadeobjetoO veredito do esquema oficial da ANS sobre o XML importado.
xsdValidobooleanoO documento passou no esquema oficial da ANS (XSD). Lote inválido é recusado antes de ir à operadora.
guiasinteiroAs guias do documento.
importadoEmtextoQuando este documento entrou no Miydas, em ISO 8601 com fuso.

Exemplo de retorno

{
  "data": [
    {
      "id": "cmf3k2x9a0001lti",
      "numeroLote": "2026070112",
      "competencia": "2026-07",
      "tipoGuia": "SP_SADT",
      "versaoTiss": "4.01.00",
      "origem": "IMPORTADO",
      "situacao": "IMPORTADO",
      "protocolo": "4530775",
      "emitidoEm": "2026-07-01",
      "transmitidoEm": null,
      "valorTotal": "12840.55",
      "conformidade": {
        "xsdValido": true
      },
      "guias": 42,
      "importadoEm": "2026-07-03T09:11:00.000Z"
    }
  ],
  "paginacao": {
    "total": 1,
    "limite": 20,
    "deslocamento": 0,
    "temMais": false
  }
}

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_listar

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

Esta rota não tem erro próprio: só os comuns a qualquer chamada com chave — chave ausente ou inválida, escopo insuficiente, parâmetro recusado e erro interno.

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.