Paginação e filtros

Todos os query params são opcionais. A consulta retorna as Vendas da empresa autenticada. order_id usa busca parcial; uuid, type, status, customer_email e customer_document_number usam correspondência exata.

Os padrões são page=1, size=10, sort=created_at e dir=desc. dir depende do envio de sort. Os enums listam valores conhecidos; valores desconhecidos em type e status não têm rejeição por enum garantida.

status refere-se à Venda. OVERPAID está declarado no código, mas suas condições de atribuição à Venda estão a confirmar.

Valores

Valores monetários são inteiros em centavos (1000 = R$ 10,00). Valores iguais ao mínimo ou ao máximo informado também entram no resultado. amount_end < amount_start retorna HTTP 400 quando ambos são enviados.

Datas

• Formatos aceitos: YYYY-MM-DD, YYYY-MM-DDTHH:mm:ss, YYYY-MM-DD HH:mm:ss e RFC 3339 com Z ou offset.
• Sem offset, a interpretação inicial é UTC. Datas sem horário representam meia-noite; _end não se estende ao fim do dia. Registros exatamente nos limites considerados pelo filtro também entram no resultado.
• created_at_* e updated_at_* somam três horas ao valor interpretado, mesmo com offset. due_date_* e expiry_date_* não recebem esse acréscimo.
• Datas inválidas podem ser ignoradas, sem erro de validação garantido.