IAXYS · Orquestrador de integração
Vendas da Mobility direto na Omie, sem o WOOFFICE no meio.
Uma API JSON recebe cada reserva de locação, cria cliente, Ordem de Serviço e títulos financeiros na Omie, e devolve à Mobility tudo o que acontece depois, como baixas e faturamento.
- Rotas
- 33
- Regras de negócio
- 54
- Casos reais de teste
- 16
Estado do ambiente
produção- Credenciais Omieok
- Chave da Mobilityok
- Banco de dadosok
- Parâmetros Omiependente
- Callback da Mobilitypendente
- Sessão do painelok
Reservas recebidas: 5 · persistência banco de dados
4 itens pendentes. Segredos vão na Vercel e parâmetros no banco de dados, pela aba Configurações do painel.
Como uma venda atravessa a integração
- 1
Mobility envia a reserva
POST /vendas com o JSON da reserva confirmada.
- 2
Orquestrador valida
Contrato, idempotência por reserva e mascaramento de cartão.
- 3
Omie recebe
Cliente, Ordem de Serviço, contas a receber e a pagar.
- 4
Omie avisa
Webhooks de baixa, faturamento e alterações.
- 5
Mobility é notificada
Callback assinado ou consulta por polling.
Novo módulo
Faturamento B2B (DUP)
A duplicata do WOOFFICE passa a ser montada aqui. Cada reserva com recebimento FATURADO entra na pré-DUP do cliente pelo calendário dele, o limite de crédito é consultado antes da venda e o corte valida linha a linha antes de emitir.
Limite antes da venda
A plataforma pergunta se o cliente pode faturar e quanto ainda cabe no limite (RN-01 a RN-05).
Pré-DUP em tempo real
A primeira reserva do período abre o lote com número definitivo e as seguintes entram nele (RN-06 a RN-10).
Corte com validação
Líquido recalculado, cadastro de cobrança conferido e pendência com motivo quando reprova (RN-11 a RN-14).
Trilha e conciliação
Log imutável por DUP e controles de integridade rodando todo dia (RN-25 a RN-29, C2, C3, C6, C9).
O que muda para a Mobility
Cada chamada SOAP do WOOFFICE tem uma rota equivalente. O payload mantém os nomes dos campos do XML para reduzir a adaptação do middleware.
| WOOFFICE (hoje) | Orquestrador IAXYS |
|---|---|
| ExportarVendasMobilToWooffice | POST /api/mobility/v1/vendas |
| ConsultarCrédito (BuscarDadosDaVenda) | GET /api/mobility/v1/vendas/{file}/credito |
| ConsultarCâmbio (BuscarCotacaoUltimosDias) | GET /api/mobility/v1/cotacoes |
| ExcluirVenda + nova exportação | POST /api/mobility/v1/vendas/{file}/reprocessar |
Rotas disponíveis
Todas documentadas com parâmetros, respostas e as regras de negócio que as compõem.
- POST/api/mobility/v1/vendasImportar venda
- GET/api/mobility/v1/vendas/{file}Status do File
- GET/api/mobility/v1/vendas/{file}/creditoConsultar crédito do File
- GET/api/mobility/v1/vendas/por-id/{idVenda}/creditoConsultar crédito pelo id da venda
- POST/api/mobility/v1/vendas/{file}/reprocessarReprocessar File
- GET/api/mobility/v1/vendasResumo por status
- GET/api/mobility/v1/cotacoesConsultar câmbio
- GET/api/mobility/v1/eventosEventos da Omie (polling)
- GET/api/configuracoesConsultar configurações
- PATCH/api/configuracoesAlterar configuração
- GET/api/credenciaisMinhas credenciais de API
- POST/api/credenciaisCriar credencial de API
- DELETE/api/credenciaisRevogar credencial
- GET/api/logsTrilha de auditoria das chamadas
- GET/api/mobility/v1/healthSaúde do orquestrador
- POST/api/omie/webhookReceptor de webhooks da Omie
- POST/api/mcpConector MCP (consulta por assistente de IA)
- GET/api/internal/retryRodada de reprocessamento (cron)
- GET/api/mobility/v1/faturamento/limiteLimite e elegibilidade do Faturado
- GET/api/mobility/v1/faturamento/dupsListar pré-DUPs e DUPs
- POST/api/mobility/v1/faturamento/dupsIncluir reserva faturada na pré-DUP
- GET/api/mobility/v1/faturamento/dups/{numero}Detalhe da DUP
- POST/api/mobility/v1/faturamento/dups/{numero}/fecharFechar DUP ou retirar reserva
- GET/api/mobility/v1/faturamento/conciliacaoRelatório de conciliação
- GET/api/internal/faturamentoRotina diária do faturamento (cron)
- GET/api/mobility/v1/comissoesEstoque de comissões
- POST/api/mobility/v1/comissoesRegistrar comissões da plataforma
- POST/api/mobility/v1/comissoes/eventosEventos da reserva (cancelamento, alteração, liberação)
- GET/api/mobility/v1/comissoes/documentosAVs e COMs
- GET/api/mobility/v1/comissoes/documentos/{numero}Detalhe do AV/COM e arquivos
- GET/api/mobility/v1/comissoes/conciliacaoControles C1 a C13 e relatórios de gestão
- POST/api/mobility/v1/comissoes/legadoMigração do Woofice (Fase 4)
- GET/api/internal/comissoesRotina diária das comissões (cron)