Clientes
Erro de nome duplicado: O nome fornecido já existe. : Outro cliente, fornecedor ou funcionário já está usando este nome. Por favor, use um nome diferente.” ou "Erro de nome duplicado: O nome fornecido já existe. : null
Ao sincronizar clientes com o QuickBooks, o fluxo de trabalho é o seguinte:
A Teachworks envia uma solicitação ao QuickBooks para encontrar quaisquer registros de clientes ativos existentes que tenham o mesmo nome e sobrenome.
Caso nenhuma correspondência seja encontrada, o QuickBooks enviará uma resposta informando que não existe nenhum cliente ativo com esse nome e sobrenome.
A Teachworks enviará uma solicitação para criar um novo cliente.
O QuickBooks enviará uma mensagem de erro informando que o nome já existe.
A mensagem de erro aparece por um dos seguintes motivos:
Existe um cliente no QuickBooks com o mesmo nome e sobrenome, mas ele está inativo no sistema.
Existe um cliente no QuickBooks com nome e sobrenome diferentes dos registrados no Teachworks, mas o nome de exibição é o mesmo que o nome e sobrenome cadastrados no Teachworks.
Existem espaços em branco extras no primeiro ou último nome do cliente no QuickBooks.
Nos casos acima, ao tentar criar um novo cliente, o QuickBooks combina automaticamente o primeiro e o último nome para criar um Nome de Exibição e, se esse Nome de Exibição já existir, o QuickBooks retornará um erro de Nome Duplicado.
Para corrigir isso, localize o perfil do cliente no QuickBooks e verifique se os campos de nome e sobrenome são idênticos aos campos de nome e sobrenome no Teachworks. Se já forem, procure um perfil correspondente em seus Clientes Inativos no QuickBooks e altere o status para "Ativo". Em seguida, sincronize novamente.
Faturas e Pagamentos
ID de referência inválido: ID de referência inválido: Line.SalesItemLineDetail.ItemRef
Essa mensagem de erro provavelmente é causada por um serviço que foi excluído no QuickBooks. Quando um serviço é criado no Teachworks e sincronizado com o QuickBooks pela primeira vez, um ID exclusivo é criado para ele no QuickBooks. Esse ID é então armazenado no QuickBooks.
Teachworks.
Sempre que você sincroniza com o QuickBooks, o feed procura esse ID exclusivo e, se não o encontrar, você receberá uma mensagem de erro. Felizmente, não há opção de exclusão permanente no QuickBooks — os itens são apenas definidos como "inativos", então você pode reativar o serviço no QuickBooks, o que deve resolver o problema. Em seguida, você pode tentar a sincronização novamente.
CustomerRef é obrigatório: CustomerRef está faltando na solicitação.
Esse erro ocorre quando o cliente ainda não foi sincronizado com sua conta do QuickBooks. Isso pode ser resolvido sincronizando primeiro o perfil do cliente vinculado à fatura ou ao pagamento.
Cliente inválido: O cliente que você especificou foi excluído. Não é possível criar ou editar uma transação com um cliente excluído.
Esse erro significa que o perfil do cliente está inativo no QuickBooks. Você precisará localizá-lo na sua conta do QuickBooks e alterar o status para ativo novamente. Depois disso, você poderá sincronizar a fatura ou o pagamento com o QuickBooks.
Período da conta encerrado: O período da conta foi encerrado.
Esse erro significa que seus períodos contábeis no QuickBooks estão fechados. Para resolver isso, você precisará atualizar a data de fechamento contábil na sua conta do QuickBooks.
Não foi possível vincular o ID da transação: Não foi possível validar as transações vinculadas.
Este erro significa que você já possui um pagamento ou nota de crédito alocado à fatura, portanto, não é mais possível editá-lo. Para resolver isso, desvincule o pagamento ou nota de crédito da(s) fatura(s) em sua conta do QuickBooks Online e, em seguida, sincronize novamente seus registros do Teachworks.
ID de referência inválido: o produto/serviço atribuído a esta transação foi excluído. Antes de modificar esta transação, você deve restaurar o *Nome do Serviço*.
Esse erro ocorre devido a um serviço desativado em sua conta do QuickBooks. Você precisará localizá-lo em sua conta do QuickBooks e reativá-lo para sincronizar as faturas.
Serviços
ID de referência inválido: ID de referência inválido: Elemento de contas com ID 133 não encontrado
Essa mensagem de erro ocorre devido ao uso de uma conta de vendas inexistente ou inativa. Sempre que houver alguma alteração em suas contas no QuickBooks, você precisará atualizar a página de Configurações de Sincronização no Teachworks para que a sincronização seja feita usando as contas corretas.
Notas de Crédito
Ocorreu um erro de aplicação ao processar sua solicitação: Falha do sistema Erro: java.lang.NumberFormatException: Para a string de entrada: ""
Esta mensagem de erro significa que o cliente associado à nota de crédito ainda não foi sincronizado.
Integração com o QuickBooks:
concessão_inválida: {"erro":"concessão_inválida"}
Esse erro ocorrerá se você tiver removido a autorização do Teachworks da sua conta do QuickBooks. Para resolver esse erro, você deve desconectar a integração do QuickBooks na sua conta do Teachworks e, em seguida, reconectá-la.
invalid_grant: Solicitação não autorizada: O usuário não é membro do domínio especificado.
Esse erro ocorrerá se a conta de usuário do QuickBooks usada para conectar o Teachworks ao QuickBooks não estiver mais autorizada a se conectar à sua conta do QuickBooks ou não existir mais.
Isso pode ocorrer se sua empresa de contabilidade conectou sua conta Teachworks à sua conta QuickBooks usando a conta de usuário QuickBooks deles, e o acesso deles à sua conta QuickBooks foi revogado posteriormente.
mensagem=Falha na autenticação do usuário; código de erro=003200; código de status=401
As credenciais de login do QuickBooks Online usadas para conectar a sincronização não são mais válidas. Clique no link "Desconectar" na barra lateral da integração com o QuickBooks e, em seguida, reconecte-se com uma conta válida.