Manual de erros ZoopException

Consulte os erros retornados pelo zoop-pos-core, com código, mensagem, classe, descrição e causas prováveis.

📌
Legenda
Código: quatro dígitos AABB: AA identifica a seção (Pagamento = 10, Cancelamento = 20, Comprovante = 30, ...; da 10ª seção em diante usa-se 91–95 para manter 4 dígitos). BB é a ordem dentro da seção (01, 02, ...). Não substitui o errorCode da API.
Erro: valor de errorCode na SDK (SCREAMING_SNAKE_CASE).
Descrição: resumo do que o usuário final ou o log costumam refletir.
Causas: origem técnica ou de processo mais frequente — não exclui outras causas; use o cause encadeado no código para diagnóstico fino.

Pagamento

1001 — Valor da transação acima do limite configurado

Mensagem: Valor da transação acima do limite configurado.


Erro	`ZOOP_PAYMENT_INVALID_AMOUNT`
Classe	`ZoopPaymentInvalidTransactionValueException`
Descrição	Valor da transação acima do limite configurado.
Causas	Valor informado ultrapassa o limite de transação definido na configuração do seller/terminal.

1002 — Falha ao determinar as aplicações de pagamento aceitas na transação

Mensagem: Falha ao determinar as aplicações de pagamento aceitas na transação.


Erro	`ZOOP_PAYMENT_FETCH_PAYMENT_APPLICATIONS_FAILED`
Classe	`FetchPaymentApplicationsException`
Descrição	Falha ao determinar as aplicações de pagamento aceitas na transação.
Causas	Backend ou parâmetros não retornaram AIDs/produtos aceitos; rede, tabela ou configuração incompleta.

1003 — Não foi possível iniciar a operação Pix

Mensagem: Não foi possível iniciar a operação Pix.


Erro	`ZOOP_PAYMENT_PIX_TRANSACTION_CREATION_FAILED`
Classe	`PixTransactionCreationFailedException`
Descrição	Não foi possível iniciar a operação Pix.
Causas	Falha ao criar cobrança Pix na API ou resposta inválida; conectividade ou credenciais.

1004 — Não foi possível iniciar a operação

Mensagem: Não foi possível iniciar a operação.


Erro	`ZOOP_PAYMENT_TRANSACTION_CREATION_FAILED`
Classe	`TransactionCreationFailedException`
Descrição	Não foi possível iniciar a operação.
Causas	Criação da transação no backend falhou (rede, validação de payload ou indisponibilidade).

1005 — Falha ao determinar o autorizador da transação

Mensagem: Falha ao determinar o autorizador da transação.


Erro	`ZOOP_PAYMENT_FETCH_TRANSACTION_AUTHORIZER`
Classe	`FetchTransactionAuthorizerException`
Descrição	Falha ao determinar o autorizador da transação.
Causas	Não foi possível resolver o autorizador a partir do contexto (configuração, marketplace ou API).

1006 — Operação cancelada

Mensagem: Operação cancelada.


Erro	`ZOOP_PAYMENT_PIX_TRANSACTION_CANCELLED`
Classe	`PixTransactionCancelledException`
Descrição	Operação cancelada.
Causas	Fluxo Pix cancelado pelo usuário, pelo parceiro ou por timeout de interação.

1007 — Não foi possível exibir o QR Code no terminal

Mensagem: Não foi possível exibir o QR Code no terminal.


Erro	`ZOOP_PAYMENT_PIX_QRCODE_UNAVAILABLE`
Classe	`PixQRCodeUnavailableException`
Descrição	Não foi possível exibir o QR Code no terminal.
Causas	Pinpad/terminal não suportou exibição ou callback de UI falhou.

1008 — Callback de criação do QR Code faltando

Mensagem: Callback de criação do QR Code faltando.


Erro	`ZOOP_PAYMENT_MISSING_PIX_QRCODE_CALLBACK`
Classe	`MissingPixQRCodeCallbackException`
Descrição	Callback de criação do QR Code faltando.
Causas	App integrador não implementou o callback exigido para exibir/gerar QR Code.

1009 — Callback de seleção de menu faltando

Mensagem: Callback de seleção de menu faltando.


Erro	`ZOOP_PAYMENT_MISSING_MENU_SELECTION_CALLBACK`
Classe	`MissingMenuSelectionCallbackException`
Descrição	Callback de seleção de menu faltando.
Causas	Fluxo exige seleção em menu e o callback não foi registrado no request.

1010 — Callback de opção de pagamento faltando

Mensagem: Callback de opção de pagamento faltando.


Erro	`ZOOP_PAYMENT_MISSING_PAYMENT_TYPE_CALLBACK`
Classe	`MissingPaymentTypeCallbackException`
Descrição	Callback de opção de pagamento faltando.
Causas	É necessário escolher débito/crédito/etc. e o callback não foi fornecido.

1011 — Opção de pagamento faltando

Mensagem: Opção de pagamento faltando.


Erro	`ZOOP_PAYMENT_MISSING_PAYMENT_TYPE`
Classe	`MissingPaymentTypeException`
Descrição	Opção de pagamento faltando.
Causas	Request sem tipo de pagamento quando o fluxo exige essa informação.

1012 — Callback de PIN faltando

Mensagem: Callback de PIN faltando.


Erro	`ZOOP_PAYMENT_MISSING_PIN_CALLBACK`
Classe	`MissingPinCallbackException`
Descrição	Callback de PIN faltando.
Causas	Operação exige PIN e o integrador não forneceu o callback de captura.

1013 — Callback do ID da transação faltando

Mensagem: Callback do ID da transação faltando.


Erro	`ZOOP_PAYMENT_MISSING_TRANSACTION_ID_CALLBACK`
Classe	`MissingTransactionIdCallbackException`
Descrição	Callback do ID da transação faltando.
Causas	Fluxo precisa do ID da transação via callback e ele não foi configurado.

1014 — Valor da transação faltando

Mensagem: Valor da transação faltando.


Erro	`ZOOP_PAYMENT_MISSING_AMOUNT`
Classe	`MissingAmountException`
Descrição	Valor da transação faltando.
Causas	Amount ausente ou zero onde o fluxo exige valor explícito.

1015 — Callback de mensagem faltando

Mensagem: Callback de mensagem faltando.


Erro	`ZOOP_PAYMENT_MISSING_MESSAGE_CALLBACK`
Classe	`MissingMessageCallbackException`
Descrição	Callback de mensagem faltando.
Causas	Exibição de mensagem ao usuário requer callback não registrado.

1016 — Callback de leitura de dados faltando

Mensagem: Callback de leitura de dados faltando.


Erro	`ZOOP_PAYMENT_MISSING_USER_INPUT`
Classe	`MissingUserInputException`
Descrição	Callback de leitura de dados faltando.
Causas	Coleta de dado adicional (CPF, CVV, etc.) requer callback ausente.

1017 — Tempo excedido

Mensagem: Tempo excedido.


Erro	`ZOOP_PAYMENT_PIX_TRANSACTION_TIMEOUT`
Classe	`PixTransactionTimeoutException`
Descrição	Tempo excedido.
Causas	Pix não concluiu dentro do tempo (rede, confirmação ou espera do pagador).

1018 — Falha na transação Pix

Mensagem: Falha na transação Pix.


Erro	`ZOOP_PAYMENT_PIX_TRANSACTION_FAILED`
Classe	`PixTransactionFailedException`
Descrição	Falha na transação Pix.
Causas	Pagamento Pix recusado, expirado ou erro retornado pelo processamento.

1019 — Falha na transação

Mensagem: Falha na transação.


Erro	`ZOOP_PAYMENT_TRANSACTION_FAILED`
Classe	`TransactionFailedException`
Descrição	Falha na transação.
Causas	Autorização/captura negada ou erro de adquirente sem mapeamento específico.

1020 — Pagamento não encontrado

Mensagem: Pagamento não encontrado.


Erro	`ZOOP_PAYMENT_NO_PAYMENT_FOUND`
Classe	`NoPaymentFoundException`
Descrição	Pagamento não encontrado.
Causas	Consulta por ID de pagamento ou estado local não encontrou registro.

1021 — Pagamento não inicializado

Mensagem: Pagamento não inicializado.


Erro	`ZOOP_PAYMENT_INITIALIZE_PAYMENT`
Classe	`InitializePaymentException`
Descrição	Pagamento não inicializado.
Causas	Uso da API de pagamento antes de `initialize` ou estado interno inconsistente.

1022 — Tipo de pagamento não habilitado

Mensagem: Tipo de pagamento não habilitado.


Erro	`ZOOP_PAYMENT_PAYMENT_TYPE_DISABLED`
Classe	`PaymentTypeDisabledException`
Descrição	Tipo de pagamento não habilitado.
Causas	Seller/terminal não tem o meio (ex.: Pix, débito) habilitado na configuração.

Cancelamento (void)

2001 — Transação não encontrada

Mensagem: Transação não encontrada.


Erro	`ZOOP_VOID_TRANSACTION_NOT_FOUND`
Classe	`TransactionNotFoundException`
Descrição	Transação não encontrada.
Causas	ID inválido, transação fora do escopo do terminal ou já removida do armazenamento local.

2002 — Falha ao processar cartão

Mensagem: Falha ao processar cartão.


Erro	`ZOOP_VOID_CARD_PROCESSING_FAILED`
Classe	`CardProcessingFailedException`
Descrição	Falha ao processar cartão.
Causas	Leitura EMV/contactless ou comando no pinpad falhou durante o void.

2003 — Opção de pagamento inválida

Mensagem: Opção de pagamento inválida.


Erro	`ZOOP_VOID_INVALID_PAYMENT_METHOD`
Classe	`InvalidPaymentMethodException`
Descrição	Opção de pagamento inválida.
Causas	Método informado não corresponde ao da transação original ou é incompatível.

2004 — Nenhuma opção de pagamento fornecida

Mensagem: Nenhuma opção de pagamento fornecida.


Erro	`ZOOP_VOID_EMPTY_PAYMENT_METHOD`
Classe	`EmptyPaymentMethodException`
Descrição	Nenhuma opção de pagamento fornecida.
Causas	Lista de métodos vazia quando o fluxo de cancelamento exige escolha.

2005 — Falha ao obter tipo de pagamento

Mensagem: Falha ao obter tipo de pagamento.


Erro	`ZOOP_VOID_FETCH_PAYMENT_METHOD`
Classe	`FetchPaymentMethodException`
Descrição	Falha ao obter tipo de pagamento.
Causas	Não foi possível recuperar o método salvo ou suportado para estorno.

2006 — Produtos de pagamento não encontrados

Mensagem: Produtos de pagamento não encontrados.


Erro	`ZOOP_VOID_FETCH_PAYMENT_PRODUCTS`
Classe	`FetchPaymentProductsException`
Descrição	Produtos de pagamento não encontrados.
Causas	Produtos/carteiras necessários ao void não estão na carga ou na resposta da API.

2007 — Falha ao cancelar operação

Mensagem: Falha ao cancelar operação.


Erro	`ZOOP_VOID_CANCEL_OPERATION_FAILED`
Classe	`CancelOperationFailedException`
Descrição	Falha ao cancelar operação.
Causas	Comando de cancelamento no pinpad ou backend retornou erro.

2008 — Callback de cancelamento não fornecido

Mensagem: Callback de cancelamento não fornecido.


Erro	`ZOOP_VOID_MISSING_VOID_CALLBACK`
Classe	`MissingVoidCallbackException`
Descrição	Callback de cancelamento não fornecido.
Causas	Integrador não registrou callback obrigatório do fluxo de void.

Comprovante

3001 — Comprovante não encontrado

Mensagem: Comprovante não encontrado.


Erro	`ZOOP_RECEIPT_FETCH_RECEIPT`
Classe	`FetchReceiptException`
Descrição	Comprovante não encontrado.
Causas	Transação sem comprovante disponível ou falha ao buscar na API/armazenamento.

3002 — Falha ao enviar SMS

Mensagem: Falha ao enviar SMS.


Erro	`ZOOP_RECEIPT_SEND_SMS_RECEIPT`
Classe	`SendSmsReceiptException`
Descrição	Falha ao enviar SMS.
Causas	Serviço de SMS indisponível, número inválido ou erro do provedor.

3003 — Parâmetros de SMS não fornecidos

Mensagem: Parâmetros de SMS não fornecidos.


Erro	`ZOOP_RECEIPT_MISSING_SMS_PARAMETERS`
Classe	`MissingSmsParametersException`
Descrição	Parâmetros de SMS não fornecidos.
Causas	Telefone ou dados obrigatórios para envio do SMS ausentes no request.

3004 — Dados de impressão faltando

Mensagem: Dados de impressão faltando.


Erro	`ZOOP_RECEIPT_MISSING_PRINT_DATA`
Classe	`MissingPrintDataException`
Descrição	Dados de impressão faltando.
Causas	Payload de impressão incompleto para o driver/pinpad.

3005 — Tipo de recibo faltando

Mensagem: Tipo de recibo faltando.


Erro	`ZOOP_RECEIPT_MISSING_RECEIPT_TYPE`
Classe	`MissingReceiptTypeException`
Descrição	Tipo de recibo faltando.
Causas	Não informado se é cliente, estabelecimento, resumo, etc.

3006 — Falha ao imprimir recibo

Mensagem: Falha ao imprimir recibo.


Erro	`ZOOP_RECEIPT_PRINT`
Classe	`PrintException`
Descrição	Falha ao imprimir recibo.
Causas	Impressora/pinpad com falha de papel, conexão ou comando de impressão.

Comando

4001 — Comando não permitido

Mensagem: Comando não permitido.


Erro	`ZOOP_COMMAND_COMMAND_NOT_ALLOWED`
Classe	`CommandNotAllowedException`
Descrição	Comando não permitido.
Causas	Estado da sessão ou política impediu o comando (ex.: fora de ordem ou sem permissão).

4002 — Comando não encontrado

Mensagem: Comando não encontrado.


Erro	`ZOOP_COMMAND_COMMAND_NOT_FOUND`
Classe	`CommandNotFoundException`
Descrição	Comando não encontrado.
Causas	Identificador de comando desconhecido ou não registrado no registry.

4003 — Metadados excedem 512 caracteres

Mensagem: Metadados excedem 512 caracteres.


Erro	`ZOOP_COMMAND_COMMAND_METADATA_LENGTH`
Classe	`CommandMetadataLengthException`
Descrição	Metadados excedem 512 caracteres.
Causas	Payload de metadados do plugin maior que o limite do protocolo.

4004 — Tamanho de comando inválido

Mensagem: Tamanho de comando inválido.


Erro	`ZOOP_COMMAND_COMMAND_LENGTH`
Classe	`CommandLengthException`
Descrição	Tamanho de comando inválido.
Causas	Frame viola o tamanho esperado do pacote de comando.

4005 — Não foi possível desserializar a informação

Mensagem: Não foi possível desserializar a informação.


Erro	`ZOOP_COMMAND_DESERIALIZE`
Classe	`DeserializeException`
Descrição	Não foi possível desserializar a informação.
Causas	JSON/corpo malformado ou versão incompatível do schema.

4006 — Padrão inválido

Mensagem: Padrão inválido.


Erro	`ZOOP_COMMAND_INVALID_COMMAND_PATTERN`
Classe	`InvalidCommandPatternException`
Descrição	Padrão inválido.
Causas	Comando não segue o padrão nomeado na convenção da SDK.

4007 — Falha na execução do comando

Mensagem: Falha na execução do comando.


Erro	`ZOOP_COMMAND_COMMAND_EXECUTION_FAILED`
Classe	`CommandExecutionFailedException`
Descrição	Falha na execução do comando.
Causas	Handler do comando lançou erro ou retornou falha de negócio.

4008 — Byte de controle não encontrado

Mensagem: Byte de controle não encontrado.


Erro	`ZOOP_COMMAND_EMPTY_CONTROL_BYTE`
Classe	`EmptyControlByteException`
Descrição	Byte de controle não encontrado.
Causas	Pacote truncado ou protocolo violado na posição do control byte.

4009 — Byte de controle inválido

Mensagem: Byte de controle inválido.


Erro	`ZOOP_COMMAND_INVALID_CONTROL_BYTE`
Classe	`InvalidControlByteException`
Descrição	Byte de controle inválido.
Causas	Valor do control byte não corresponde a nenhum estado esperado.

4010 — Pacote inválido

Mensagem: Pacote inválido.


Erro	`ZOOP_COMMAND_INVALID_PACKET`
Classe	`InvalidPacketException`
Descrição	Pacote inválido.
Causas	Checksum, delimitadores ou estrutura do pacote incorretos.

4011 — Mensagem faltando

Mensagem: Mensagem faltando.


Erro	`ZOOP_COMMAND_MISSING_MESSAGE`
Classe	`MissingMessageException`
Descrição	Mensagem faltando.
Causas	Corpo obrigatório ausente após o header de comando.

4012 — Tamanho máximo de mensagem é 32 caracteres

Mensagem: Tamanho máximo de mensagem é 32 caracteres.


Erro	`ZOOP_COMMAND_MESSAGE_LENGTH`
Classe	`MaxMessageLengthException`
Descrição	Tamanho máximo de mensagem é 32 caracteres.
Causas	Campo de mensagem curta do protocolo excedeu 32 caracteres.

Autorização

5001 — Ação proibida

Mensagem: Ação proibida.


Erro	`ZOOP_AUTHORIZATION_FORBIDDEN`
Classe	`ForbiddenException`
Descrição	Ação proibida.
Causas	Token/sessão sem permissão para a operação ou regra de autorização negou.

Gateway

6001 — Falha ao buscar o autorizador de gateway atual

Mensagem: Falha ao buscar o autorizador de gateway atual.


Erro	`ZOOP_GATEWAY_FETCH_GATEWAY`
Classe	`FetchGatewayException`
Descrição	Falha ao buscar o autorizador de gateway atual.
Causas	Configuração de gateway não resolvida ou API de roteamento indisponível.

Provisionamento

7001 — ID do terminal não encontrado

Mensagem: ID do terminal não encontrado.


Erro	`ZOOP_PROVISIONING_FETCH_TERMINAL_ID_FAILED`
Classe	`FetchTerminalIdException`
Descrição	ID do terminal não encontrado.
Causas	Terminal não provisionado na API ou serial/marketplace incorretos.

7002 — Falha ao obter configurações de pagamento do terminal

Mensagem: Falha ao obter configurações de pagamento do terminal.


Erro	`ZOOP_PROVISIONING_FETCH_TERMINAL_PAYMENT_CONFIGURATION_FAILED`
Classe	`FetchPaymentConfigurationException`
Descrição	Falha ao obter configurações de pagamento do terminal.
Causas	Endpoint de configuração falhou ou retornou vazio.

7003 — Falha ao determinar o adquirente da transação

Mensagem: Falha ao determinar o adquirente da transação.


Erro	`ZOOP_PROVISIONING_FETCH_ACQUIRER_FAILED`
Classe	`FetchAcquirerException`
Descrição	Falha ao determinar o adquirente da transação.
Causas	Mapeamento seller/produto não encontrou adquirente.

7004 — Menu de seleção não está presente na requisição

Mensagem: Menu de seleção não está presente na requisição.


Erro	`ZOOP_PROVISIONING_FETCH_SELECTION_MENU`
Classe	`FetchSelectionMenuException`
Descrição	Menu de seleção não está presente na requisição.
Causas	Request exige estrutura de menu que não foi enviada.

7005 — Falha ao obter parâmetros

Mensagem: Falha ao obter parâmetros.


Erro	`ZOOP_PROVISIONING_FETCH_PARAMETERS`
Classe	`FetchParametersException`
Descrição	Falha ao obter parâmetros.
Causas	Download de parâmetros operacionais falhou (rede ou 4xx/5xx).

7006 — Falha ao atualizar parâmetros

Mensagem: Falha ao atualizar parâmetros.


Erro	`ZOOP_PROVISIONING_UPDATE_PARAMETERS`
Classe	`UpdateParametersException`
Descrição	Falha ao atualizar parâmetros.
Causas	Persistência ou aplicação de parâmetros no dispositivo falhou.

7007 — Faltando parâmetro

Mensagem: Faltando parâmetro.


Erro	`ZOOP_PROVISIONING_MISSING_SETUP_PARAMETER`
Classe	`MissingSetupParameterException`
Descrição	Faltando parâmetro.
Causas	Campo obrigatório de setup ausente no request.

7008 — Erro na configuração

Mensagem: Erro na configuração.


Erro	`ZOOP_PROVISIONING_SETUP`
Classe	`SetupException`
Descrição	Erro na configuração.
Causas	Pipeline de setup encontrou erro genérico (validação, storage ou API).

7009 — Número de série inválido

Mensagem: Número de série inválido.


Erro	`ZOOP_PROVISIONING_INVALID_SERIAL`
Classe	`InvalidSerialException`
Descrição	Número de série inválido.
Causas	Formato ou checksum do serial não aceito pela regra de negócio.

7010 — Tamanho máximo do número de série é 20

Mensagem: Tamanho máximo do número de série é 20.


Erro	`ZOOP_PROVISIONING_MAX_LENGTH_SERIAL`
Classe	`MaxLengthSerialException`
Descrição	Tamanho máximo do número de série é 20.
Causas	Serial informado ultrapassa o limite.

7011 — Callback não fornecido

Mensagem: Callback não fornecido.


Erro	`ZOOP_PROVISIONING_MISSING_CALLBACK`
Classe	`MissingCallbackException`
Descrição	Callback não fornecido.
Causas	Fluxo de provisioning exige callback obrigatório não registrado.

7012 — Callback de emparelhamento não fornecido

Mensagem: Callback de emparelhamento não fornecido.


Erro	`ZOOP_PROVISIONING_MISSING_PAIRING_CALLBACK`
Classe	`MissingPairingCallbackException`
Descrição	Callback de emparelhamento não fornecido.
Causas	Emparelhamento Bluetooth/pinpad requer callback ausente.

7013 — Cliente WebSocket nativo não inicializado

Mensagem: Cliente WebSocket nativo não inicializado.


Erro	`ZOOP_PROVISIONING_WEBSOCKET_INITIALIZATION`
Classe	`WebsocketInitializationException`
Descrição	Cliente WebSocket nativo não inicializado.
Causas	Uso de WS antes do `initialize` na plataforma nativa.

7014 — Cliente HTTP nativo não inicializado

Mensagem: Cliente HTTP nativo não inicializado.


Erro	`ZOOP_PROVISIONING_HTTP_CLIENT_INITIALIZATION`
Classe	`HttpClientInitializationException`
Descrição	Cliente HTTP nativo não inicializado.
Causas	Chamada HTTP antes da inicialização do client nativo.

7015 — Falha verificando chaves transacionais

Mensagem: Falha verificando chaves transacionais.


Erro	`ZOOP_PROVISIONING_VERIFY_TRANSACTIONAL_KEYS`
Classe	`VerifyTransactionalKeysException`
Descrição	Falha verificando chaves transacionais.
Causas	Chaves ausentes, corrompidas ou incompatíveis com o terminal.

7016 — Serviço já registrado

Mensagem: Serviço já registrado.


Erro	`ZOOP_PROVISIONING_SERVICE_ALREADY_REGISTERED`
Classe	`ServiceAlreadyRegisteredException`
Descrição	Serviço já registrado.
Causas	Tentativa de registrar o mesmo serviço singleton duas vezes.

7017 — Sem resposta da API de configurações

Mensagem: Sem resposta da API de configurações.


Erro	`ZOOP_PROVISIONING_FETCH_API_SETTINGS`
Classe	`FetchApiSettingsException`
Descrição	Sem resposta da API de configurações.
Causas	API de settings timeout ou corpo vazio.

7018 — É necessária uma sessão válida

Mensagem: É necessária uma sessão válida.


Erro	`ZOOP_PROVISIONING_VALID_SESSION`
Classe	`ValidSessionException`
Descrição	É necessária uma sessão válida.
Causas	Operação chamada sem login/sessão ativa quando obrigatória.

7019 — Aplicação não pode inserir transação no banco

Mensagem: Aplicação não pode inserir transação no banco.


Erro	`ZOOP_PROVISIONING_DATABASE_INSERTION`
Classe	`DatabaseInsertionException`
Descrição	Aplicação não pode inserir transação no banco.
Causas	Restrição de ambiente: app host não permite escrita no DB local.

Integração

8001 — Não autorizado para subscrição

Mensagem: Não autorizado para subscrição.


Erro	`ZOOP_INTEGRATION_SUBSCRIBE_AUTHORIZATION`
Classe	`SubscribeAuthorizationException`
Descrição	Não autorizado para subscrição.
Causas	Credenciais ou escopo insuficiente para subscrição de eventos.

8002 — Não foi possível verificar o token

Mensagem: Não foi possível verificar o token.


Erro	`ZOOP_INTEGRATION_FETCH_TOKEN_STATUS`
Classe	`FetchTokenStatusException`
Descrição	Não foi possível verificar o token.
Causas	Endpoint de introspecção de token falhou ou rede.

8003 — Resposta não suportada

Mensagem: Resposta não suportada.


Erro	`ZOOP_INTEGRATION_UNSUPPORTED_RESPONSE`
Classe	`UnsupportedResponseException`
Descrição	Resposta não suportada.
Causas	Versão de API ou formato de resposta não reconhecido pelo client.

8004 — Falha na abertura do socket Bluetooth

Mensagem: Falha na abertura do socket Bluetooth.


Erro	`ZOOP_INTEGRATION_OPEN_BLUETOOTH_SOCKET`
Classe	`OpenBluetoothSocketException`
Descrição	Falha na abertura do socket Bluetooth.
Causas	Permissões, pairing ou driver impediram abrir o socket.

8005 — Socket Bluetooth já aberto

Mensagem: Socket Bluetooth já aberto.


Erro	`ZOOP_INTEGRATION_BLUETOOTH_SOCKET_ALREADY_OPENED`
Classe	`BluetoothSocketAlreadyOpenedException`
Descrição	Socket Bluetooth já aberto.
Causas	Segunda abertura sem fechar a conexão anterior.

8006 — Adaptador não disponível

Mensagem: Adaptador não disponível.


Erro	`ZOOP_INTEGRATION_BLUETOOTH_ADAPTER`
Classe	`BluetoothAdapterException`
Descrição	Adaptador não disponível.
Causas	Hardware sem BT, driver ausente ou adaptador desligado no SO.

8007 — Falha na comunicação Bluetooth

Mensagem: Falha na comunicação Bluetooth.


Erro	`ZOOP_INTEGRATION_BLUETOOTH_COMMUNICATION`
Classe	`BluetoothCommunicationException`
Descrição	Falha na comunicação Bluetooth.
Causas	Perda de link, interferência ou timeout na troca de bytes.

8008 — Bluetooth desabilitado

Mensagem: Bluetooth desabilitado.


Erro	`ZOOP_INTEGRATION_BLUETOOTH_DISABLED`
Classe	`BluetoothDisabledException`
Descrição	Bluetooth desabilitado.
Causas	Usuário ou política do SO desativou o Bluetooth.

8009 — Aparelho sem endereço válido

Mensagem: Aparelho sem endereço válido.


Erro	`ZOOP_INTEGRATION_BLUETOOTH_ADDRESS`
Classe	`BluetoothAddressException`
Descrição	Aparelho sem endereço válido.
Causas	MAC inválido ou dispositivo não pareado corretamente.

8010 — Nenhum aparelho selecionado

Mensagem: Nenhum aparelho selecionado.


Erro	`ZOOP_INTEGRATION_BLUETOOTH_NO_DEVICE_SELECTED`
Classe	`BluetoothNoDeviceSelected`
Descrição	Nenhum aparelho selecionado.
Causas	Fluxo exige pinpad selecionado e nenhum endereço foi definido.

Relatório

9001 — Turno não encontrado

Mensagem: Turno não encontrado.


Erro	`ZOOP_REPORT_FETCH_REPORT_SHIFT`
Classe	`FetchReportShiftException`
Descrição	Turno não encontrado.
Causas	ID de turno inexistente ou fora do intervalo consultável.

9002 — Relatório não encontrado

Mensagem: Relatório não encontrado.


Erro	`ZOOP_REPORT_FETCH_REPORT`
Classe	`FetchReportException`
Descrição	Relatório não encontrado.
Causas	Tipo/data solicitados sem dados ou API retornou 404.

9003 — Tipo de relatório inválido

Mensagem: Tipo de relatório inválido.


Erro	`ZOOP_REPORT_INVALID_REPORT_TYPE`
Classe	`InvalidReportTypeException`
Descrição	Tipo de relatório inválido.
Causas	Enum/string de tipo não reconhecido pela SDK.

9004 — Tipo de relatório não fornecido

Mensagem: Tipo de relatório não fornecido.


Erro	`ZOOP_REPORT_MISSING_REPORT_TYPE`
Classe	`MissingReportTypeException`
Descrição	Tipo de relatório não fornecido.
Causas	Request sem campo de tipo obrigatório.

9005 — Filtro do relatório não fornecido

Mensagem: Filtro do relatório não fornecido.


Erro	`ZOOP_REPORT_MISSING_REPORT_FILTER`
Classe	`MissingReportFilterException`
Descrição	Filtro do relatório não fornecido.
Causas	Filtro de data/loja/etc. ausente quando obrigatório.

9006 — Turnos encerrados não fornecidos

Mensagem: Turnos encerrados não fornecidos.


Erro	`ZOOP_REPORT_MISSING_CLOSED_SHIFTS_DATA`
Classe	`MissingClosedShiftsDataException`
Descrição	Turnos encerrados não fornecidos.
Causas	Corpo do relatório de fechamento sem lista de turnos.

Carga de tabelas

9101 — Falha ao obter a carga de tabelas

Mensagem: Falha ao obter a carga de tabelas.


Erro	`ZOOP_TABLE_LOAD_FETCH_FAILED`
Classe	`FetchTableLoadException`
Descrição	Falha ao obter a carga de tabelas.
Causas	Download da carga EMV/tabelas falhou (rede, 404 ou checksum).

9102 — Falha ao buscar a versão da carga atual

Mensagem: Falha ao buscar a versão da carga atual.


Erro	`ZOOP_TABLE_LOAD_FETCH_VERSION_FAILED`
Classe	`FetchTableLoadVersionException`
Descrição	Falha ao buscar a versão da carga atual.
Causas	Endpoint de versão indisponível ou resposta inválida.

9103 — Não foi possível salvar a nova carga de tabelas

Mensagem: Não foi possível salvar a nova carga de tabelas.


Erro	`ZOOP_TABLE_LOAD_APPLY_FAILED`
Classe	`ApplyTableLoadException`
Descrição	Não foi possível salvar a nova carga de tabelas.
Causas	Erro de I/O, permissão ou espaço ao persistir tabelas no terminal.

9104 — Tabelas não disponíveis

Mensagem: Tabelas não disponíveis.


Erro	`ZOOP_TABLE_LOAD_EMPTY_TABLE_LOAD`
Classe	`EmptyTableLoadException`
Descrição	Tabelas não disponíveis.
Causas	Primeiro uso ou reset: é necessário concluir fluxo que baixe/aplique carga.

Terminal

9201 — Terminal não ativado

Mensagem: Terminal não ativado.


Erro	`ZOOP_TERMINAL_NOT_ACTIVATED`
Classe	`ZoopTerminalNotActivatedException`
Descrição	Terminal não ativado.
Causas	Ativação não concluída ou dados de ativação apagados.

9202 — Falha na ativação do terminal

Mensagem: Falha na ativação do terminal.


Erro	`ZOOP_TERMINAL_ACTIVATION`
Classe	`ZoopTerminalActivationException`
Descrição	Falha na ativação do terminal.
Causas	API de ativação recusou, token inválido ou validação de dados.

9203 — Ativação de terminal proibida

Mensagem: Ativação de terminal proibida.


Erro	`ZOOP_TERMINAL_ACTIVATION_FORBIDDEN`
Classe	`ZoopTerminalActivationForbiddenException`
Descrição	Ativação de terminal proibida.
Causas	Regra de negócio ou marketplace bloqueou ativação neste contexto.

9204 — Tempo excedido

Mensagem: Tempo excedido.


Erro	`ZOOP_TERMINAL_TIMEOUT`
Classe	`ZoopTerminalTimeoutException`
Descrição	Tempo excedido.
Causas	Pinpad ou operação de terminal não respondeu dentro do timeout.

Segurança

9301 — Falha na validação de atestação

Mensagem: Falha na validação de atestação.


Erro	`ZOOP_SECURITY_ATTESTATION_VALIDATION`
Classe	`ZoopSecurityAttestationException`
Descrição	Falha na validação de atestação.
Causas	Play Integrity / SafetyNet ou equivalente não passou.

9302 — Execução não permitida em modo de depuração

Mensagem: Execução não permitida em modo de depuração.


Erro	`ZOOP_SECURITY_DEBUG_MODE`
Classe	`ZoopSecurityDebugException`
Descrição	Execução não permitida em modo de depuração.
Causas	App em debug e política proíbe transações reais.

9303 — Execução não permitida em emulador

Mensagem: Execução não permitida em emulador.


Erro	`ZOOP_SECURITY_EMULATOR`
Classe	`ZoopSecurityEmulatorException`
Descrição	Execução não permitida em emulador.
Causas	Ambiente detectado como emulador e bloqueado.

9304 — Execução não permitida com usuário root

Mensagem: Execução não permitida com usuário root.


Erro	`ZOOP_SECURITY_ROOT_USER`
Classe	`ZoopSecurityRootException`
Descrição	Execução não permitida com usuário root.
Causas	Dispositivo com root/jailbreak detectado.

Core (direto)

9401 — Operação cancelada

Mensagem: Operação cancelada.


Erro	`ZOOP_ABORT`
Classe	`ZoopAbortException`
Descrição	Operação cancelada.
Causas	Fluxo interrompido explicitamente (usuário ou integração).

9402 — Tempo excedido

Mensagem: Tempo excedido.


Erro	`ZOOP_TIMEOUT`
Classe	`ZoopTimeoutException`
Descrição	Tempo excedido.
Causas	Operação assíncrona ou rede excedeu o tempo máximo configurado.

9403 — Falha de conexão

Mensagem: Falha de conexão.


Erro	`ZOOP_NETWORK`
Classe	`ZoopNetworkException`
Descrição	Falha de conexão.
Causas	Sem rede, DNS, TLS ou servidor inalcançável.

9404 — Conexão encerrada

Mensagem: Conexão encerrada.


Erro	`ZOOP_CLOSED_CONNECTION`
Classe	`ZoopClosedConnectionException`
Descrição	Conexão encerrada.
Causas	Socket/canal fechado pelo peer ou pelo SO durante a operação.

9405 — Timeout inválido ou não permitido

Mensagem: Timeout inválido ou não permitido.


Erro	`ZOOP_ILLEGAL_TIMEOUT`
Classe	`ZoopIllegalTimeoutException`
Descrição	Timeout inválido ou não permitido.
Causas	Valor de timeout fora dos limites aceitos pela API ou motor.

9406 — Capacidade esperada ausente

Mensagem: Capacidade esperada ausente.


Erro	`ZOOP_CAPABILITY`
Classe	`ZoopCapabilityException`
Descrição	Capacidade esperada ausente.
Causas	Feature não suportada neste modelo de terminal ou build.

9407 — Falha na validação de normalização

Mensagem: Falha na validação de normalização.


Erro	`ZOOP_NORMALIZE`
Classe	`ZoopNormalizeValidatorException`
Descrição	Falha na validação de normalização.
Causas	Dados de entrada não passaram na normalização/validação (CPF, CEP, etc.).

9408 — Terminal não conectado

Mensagem: Terminal não conectado.


Erro	`ZOOP_UNAVAILABLE_CONNECTIVITY`
Classe	`ZoopUnavailableConnectivityException`
Descrição	Terminal não conectado.
Causas	Sem link com pinpad (USB/BT) ou serviço de transporte indisponível.

9409 — Falha de comunicação com o sistema

Mensagem: Falha de comunicação com o sistema.


Erro	`ZOOP_SYSTEM_UNAVAILABLE`
Classe	`ZoopSystemUnavailableException`
Descrição	Falha de comunicação com o sistema.
Causas	Serviço Zoop ou backend retornou indisponível ou erro transitório.

9410 — Requisição cancelada

Mensagem: Requisição cancelada.


Erro	`ZOOP_REQUEST_CANCELED`
Classe	`ZoopRequestCanceledException`
Descrição	Requisição cancelada.
Causas	Request marcado como cancelado antes de concluir (ex.: nova operação ou lifecycle).

9411 — Chave não encontrada no terminal

Mensagem: Chave não encontrada no terminal.


Erro	`ZOOP_KEY_NOT_FOUND`
Classe	`ZoopKeyNotFound`
Descrição	Chave não encontrada no terminal.
Causas	Chave criptográfica esperada não está provisionada no pinpad.

9412 — Problema com biblioteca de terceiros

Mensagem: Problema com biblioteca de terceiros.


Erro	`ZOOP_THIRD_PARTY`
Classe	`ZoopThirdPartyException`
Descrição	Problema com biblioteca de terceiros.
Causas	Dependência nativa ou SDK externo falhou (driver, BC, etc.).

9413 — Falha no protocolo EMV

Mensagem: Falha no protocolo EMV.


Erro	`ZOOP_EMV`
Classe	`ZoopEMVException`
Descrição	Falha no protocolo EMV.
Causas	Comando EMV, GPO, leitura de cartão ou resposta do chip/contactless.

9414 — Marketplace ID inválido

Mensagem: Marketplace ID inválido.


Erro	`ZOOP_ACTIVATION_MISMATCHING_MARKETPLACE_ID`
Classe	`ZoopMismatchingMarketplaceIdException`
Descrição	Marketplace ID inválido.
Causas	Marketplace da ativação não coincide com o da sessão/configuração.

Plugin

9501 — Nenhuma transação encontrada

Mensagem: Nenhuma transação encontrada.


Erro	`ZOOP_NO_TRANSACTION`
Classe	`ZoopNoTransactionException`
Descrição	Nenhuma transação encontrada.
Causas	Plugin ou fluxo local não encontrou transação ativa para a ação.

9502 — O token de ativação expirou

Mensagem: O token de ativação expirou.


Erro	`ZOOP_ACTIVATION_TOKEN_EXPIRED`
Classe	`ActivationTokenExpiredException`
Descrição	O token de ativação expirou.
Causas	Token de ativação ultrapassou validade; gerar novo fluxo de ativação.

Total: 113 tipos concretos. Fonte: core/src/commonMain/kotlin/com/zoop/pos/exception/ e plugin/exception/. Gerado por docs/_generate_zoop_exceptions_handbook.py.

Anterior: 8 - Releases
Voltar ao início: Zoop Desktop Server