FAQ
Configurações
ExportarCobrancaAdicional
É necessário habilitar a configuração Exportar Valor Net quando a cobrança adicional for do tipo Markup ou Descontado na Tarifa.
Por que a mesma transação volta em todo List?
Porque ela não foi marcada como importada. Depois de processar o item, chame o Change com ImportState = 2 e consulte o List com FilterImportState = 1. Veja Uso adequado.
Recebi o erro Credencial não liberada para esse ip de acesso
O Travellink possui bloqueio de segurança por IP na credencial. Você precisa solicitar ao suporte/consolidador que inclua o endereço IP público de saída do seu servidor na Whitelist de IPs da sua credencial de integração.
Recebi o erro GetList Error: DateFrom mandatory
A API não permite consultas abertas sem identificador direto. Informe DateFrom e DateTo (com intervalo máximo de 7 dias) ou faça uma busca direta por Locator ou Ticket. Veja as regras de validação do List.
Recebi o erro GetList Error: Maximum period exceeded - 7 days
O intervalo entre DateFrom e DateTo não pode ser superior a 7 dias. Divida a sua consulta em chamadas sequenciais para cobrir períodos maiores (por exemplo, consultando semana a semana).
Recebi o erro GetList Error: invalid transation error
Esse erro ocorre quando o parâmetro TransactionTypes é enviado contendo unicamente o tipo 13 (Corporate). A API não permite listar apenas ordens de serviço corporativas isoladas.
Como sei se a chamada foi bem-sucedida?
A API retorna HTTP 200 encapsulando o resultado ou a falha na resposta:
- Se
Success == trueeErrorsfor um array vazio[], a operação foi bem-sucedida. - Se
Success == false, a operação falhou. Inspecione o arrayErrorspara ler a mensagem da falha emErrors[i].Message.
Por que o campo Exception dentro de Errors sempre vem vazio?
Por diretriz de segurança de produção do backend .NET (System.Diagnostics.Debugger.IsAttached ? ex.ToString() : ""), o rastreamento detalhado de pilha (stack trace) só é exibido quando um depurador está atrelado ao processo no servidor. Em produção, detalhes internos do servidor são omitidos para preservar a segurança da aplicação, sendo fornecida a mensagem de erro legível no campo Message.
Por que o campo ImportState de cada item no List sempre vem como 0 (Undefined)?
Por desenho de performance da consulta no banco de dados da Wooba, a projeção do cabeçalho (TransactionHeader) preenche ImportState com 0 (Undefined). O filtro de importação é aplicado diretamente na consulta SQL via parâmetro FilterImportState = 1 (OnlyNotImported). Para verificar o status individual completo de uma transação específica, consulte o serviço Details.
Onde consigo credenciais e a URL de produção?
Diretamente com o seu contratante (Consolidador / Operadora / Agência Wooba). A Wooba fornece a tecnologia, mas as credenciais e ambientes de produção são administrados pelos próprios clientes contratantes.