Faturamento
/v1/lotes-importados/{id}/guiasAs 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
| data | GuiasDoLote | O 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
| Campo | Tipo | O que é |
|---|---|---|
| loteId | texto | O lote a que esta guia pertence, pelo identificador do Miydas. |
| numeroLote | texto | O número do lote, como ele foi transmitido à operadora. |
| guias | lista de objetos | As guias do documento. |
| tipo | texto um de: SP_SADT, CONSULTA | O tipo da guia TISS. CONSULTA não tem itens: a consulta é o próprio procedimento. |
| numeroGuiaPrestador | texto | O número que VOCÊ deu à guia. O TISS não deixa repetir dentro do prestador, e é por ele que você reencontra a guia aqui. |
| numeroGuiaOperadora | texto | O número que a OPERADORA deu à guia. Só existe depois que ela respondeu, e é o número que vale numa discussão com ela. |
| senha | texto | A senha de autorização que a operadora concedeu. É ela que autoriza a execução. |
| autorizadaEm | texto | Quando a operadora autorizou, em ISO 8601 com fuso. |
| carteira | texto | Número da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador. |
| beneficiario | texto | O 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. |
| cobrado | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| itens | lista de objetos | Vazio em CONSULTA: a consulta É o procedimento, e não tem item. |
| sequencial | inteiro | A ordem do registro dentro do documento, como a operadora a numerou. |
| tipo | texto | Natureza da linha: PROCEDIMENTO ou DESPESA (material, medicamento, taxa). |
| tabela | texto | Qual tabela o código usa (22 = TUSS procedimentos, 00 = tabela própria da operadora). Padrão 22. |
| codigo | texto | Código do item na tabela declarada. |
| descricao | texto | Descrição do item, como a fonte a informou. |
| quantidade | texto | Quantas 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. |
| valorUnitario | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| cobrado | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| executadoEm | texto | Quando a execução ocorreu, em ISO 8601 com fuso. |
| atendidaEm | texto | Data 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_guiasA 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ódigo | HTTP | Quando | O que fazer |
|---|---|---|---|
| RECURSO_NAO_ENCONTRADO | 404 | O 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.