IX

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

ERRO5

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. 1

    Mobility envia a reserva

    POST /vendas com o JSON da reserva confirmada.

  2. 2

    Orquestrador valida

    Contrato, idempotência por reserva e mascaramento de cartão.

  3. 3

    Omie recebe

    Cliente, Ordem de Serviço, contas a receber e a pagar.

  4. 4

    Omie avisa

    Webhooks de baixa, faturamento e alterações.

  5. 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
ExportarVendasMobilToWoofficePOST /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çãoPOST /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.