Faturamento
/v1/lotes-importadosOs 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
| data | lista de LoteImportado | O recurso. Os campos estão na tabela abaixo. |
| paginacao | Paginacao | Onde 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
| Campo | Tipo | O que é |
|---|---|---|
| id | texto | 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. |
| numeroLote | texto | O número do lote, como ele foi transmitido à operadora. |
| competencia | texto | Mê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. |
| tipoGuia | texto | Tipo de guia TISS: SP_SADT, CONSULTA, RESUMO_INTERNACAO, HONORARIO. |
| versaoTiss | texto | Versão do padrão TISS do documento (ex. 4.01.00). Quem dita a versão é a operadora. |
| origem | texto | IMPORTADO (veio de arquivo) | GERADO (montado aqui). |
| situacao | texto | O estado do lote importado aqui dentro — se foi lido, validado e distribuído em guias. |
| protocolo | texto | O protocolo que a operadora devolveu ao receber. É o número que prova a entrega e por onde se consulta o andamento depois. |
| emitidoEm | texto | Data que o documento declara como de emissão. Cuidado: em documento de portal, é o dia do download. |
| transmitidoEm | texto | Quando o lote foi transmitido à operadora, em ISO 8601 com fuso. |
| valorTotal | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| conformidade | objeto | O veredito do esquema oficial da ANS sobre o XML importado. |
| xsdValido | booleano | O documento passou no esquema oficial da ANS (XSD). Lote inválido é recusado antes de ir à operadora. |
| guias | inteiro | As guias do documento. |
| importadoEm | texto | Quando 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_listarA 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.