> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexx.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensagens do sistema

> Cada recusa do Apex, com o motivo e o caminho para resolver.

O Apex recusa uma ação quando executá-la deixaria o sistema num estado sem
explicação. Toda recusa diz o motivo — esta página diz o que fazer. Onde a
mensagem traz um número, um código ou um nome (`PEV-0001`, o SKU, a nota), ele
aparece aqui como exemplo.

## Pedido de venda

> [accordion] Sem saldo para reservar 3 de CAM-PRETA-M — disponível 1
>
> O disponível daquela variação não cobre a quantidade do pedido. Lembre que
> **disponível = físico − reservado − bloqueado**: pode haver mercadoria no
> depósito, reservada para outro pedido ou bloqueada (lote vencido, depósito
> de avaria).
>
> **O que fazer:** reduza a quantidade, cancele um pedido que esteja segurando
> a reserva, ou dê entrada no estoque.
>
> A aprovação é tudo ou nada — nenhuma linha é reservada pela metade. No
> produto que controla lote, a reserva pega primeiro os lotes que vencem
> antes.

> [accordion] Pedido aprovado, com o estoque reservado: reabra o pedido para alterar os itens
>
> A reserva foi feita contra as linhas exatas do pedido. Mudá-las deixaria a
> reserva apontando para o que não existe mais. Observação, data de entrega,
> endereço e transportadora continuam editáveis.
>
> **O que fazer:** reabra o pedido (menu da linha › **Reabrir pedido**). A
> reserva é liberada, as contas a receber em aberto são canceladas e o pedido
> volta para Em aberto. Ajuste os itens e aprove de novo.

> [accordion] Os itens só mudam com o pedido em aberto
>
> Depois de faturado ou enviado para a expedição, a nota e o envio foram
> feitos contra aqueles itens. Trocar a lista deixaria esses documentos
> falando de outro pedido. Observação, data de entrega, endereço e
> transportadora continuam editáveis.
>
> **O que fazer**, conforme a etapa:
>
> * **Com NF-e autorizada:** cancele a NF-e (menu da linha › **Cancelar
>   NF-e**). Depois reabra o pedido.
> * **Na Expedição, sem NF-e e ainda não despachado:** reabra direto. O
>   pedido sai da doca e volta para Em aberto.
> * **Despachado:** registre uma [devolução](https://docs.apexx.work/vendas/devolucoes.md) e, se o
>   cliente vai receber outro item, um pedido novo.

> [accordion] Pedido aprovado: reabra o pedido para mudar o cliente
>
> A frase troca "o cliente" pelo campo que você mudou: a data do pedido, o
> canal de venda, a lista de preços, o frete, o desconto, a forma ou a
> condição de pagamento, o número de parcelas.
>
> A aprovação usou esses campos: o cliente e a data viraram as contas a
> receber (o vencimento conta da data do pedido), o canal decidiu se a conta
> é do marketplace, e frete, desconto e pagamento fizeram o total e as
> parcelas. Mudar um deles deixaria as contas dizendo outra coisa.
>
> **O que fazer:** reabra o pedido (menu da linha › **Reabrir pedido**). As
> contas em aberto são canceladas e o pedido volta para Em aberto. Corrija e
> aprove de novo.

> [accordion] O cliente só muda com o pedido em aberto
>
> Vale para os mesmos campos da mensagem acima, quando o pedido já passou do
> primeiro passo da aprovação: faturado, na Expedição, despachado ou
> cancelado. A nota e o envio foram feitos com esses dados.
>
> **O que fazer**, conforme a etapa:
>
> * **Com NF-e autorizada:** cancele a NF-e e depois reabra o pedido.
> * **Na Expedição, sem NF-e e ainda não despachado:** reabra direto.
> * **Despachado:** a correção é uma [devolução](https://docs.apexx.work/vendas/devolucoes.md) e um
>   pedido novo.
> * **Cancelado:** o pedido é um documento encerrado. Use **Clonar venda**
>   para fazer outro com os dados certos.

> [accordion] Só se reabre o pedido aprovado que ainda não foi faturado nem despachado
>
> Reabrir libera a reserva e cancela as contas a receber em aberto: vale para
> o pedido Aprovado sem NF-e e para o que está na doca da Expedição sem NF-e
> e ainda não saiu. O menu só oferece **Reabrir pedido** quando dá.
>
> **O que fazer:** com NF-e autorizada, a mensagem é outra — "Cancele a NF-e
> nº 123 deste pedido antes de reabrir": cancele a nota e reabra. Com a nota
> ainda na SEFAZ, espere o retorno. Já despachado, registre uma
> [devolução](https://docs.apexx.work/vendas/devolucoes.md).

> [accordion] Cancele a NF-e nº 123 deste pedido antes de cancelar o pedido
>
> Cancelar só o pedido deixaria uma venda autorizada na SEFAZ sem pedido por
> trás. Se a nota ainda está sendo processada, a mensagem é "A NF-e deste
> pedido está na SEFAZ: aguarde o retorno antes de cancelar".
>
> **O que fazer:** use **Cancelar NF-e** no menu do pedido. Com a nota
> cancelada, **Cancelar pedido** volta a aparecer.

> [accordion] Pedido já despachado: registre uma devolução para reverter o estoque
>
> A mercadoria saiu. Cancelar aqui devolveria ao saldo algo que não está na
> prateleira. Costuma aparecer ao cancelar em lote uma seleção que tinha um
> pedido já despachado.
>
> **O que fazer:** registre uma [devolução](https://docs.apexx.work/vendas/devolucoes.md) (menu do
> pedido › **Registrar devolução**). O estoque volta quando você usar
> **Receber mercadoria** nela.

> [accordion] Pedido com estoque reservado não vai para a lixeira: cancele o pedido para liberar a reserva.
>
> Excluir esconderia o pedido da tela e deixaria a mercadoria presa —
> indisponível para outra venda, sem nenhum documento que explicasse por quê.
>
> **O que fazer:** cancele o pedido primeiro; depois ele vai para a lixeira
> normalmente.

> [accordion] Pedido aprovado não vai para a lixeira. Cancele o pedido antes de excluir.
>
> Aparece ao excluir em lote, com o número do pedido na frente: a seleção
> tinha um pedido aprovado, e nada foi excluído. O menu desse pedido já não
> oferece **Excluir**.
>
> **O que fazer:** tire o pedido da seleção, ou cancele-o antes.

> [accordion] Pedido sem itens não pode ser aprovado
>
> Não há o que reservar. Adicione ao menos uma linha com produto e quantidade.

> [accordion] Pedido cancelado não pode ser aprovado
>
> Um pedido cancelado é um fato encerrado. Crie um novo pedido — ou use
> **Clonar venda**, no menu da linha, para copiar o cancelado.

> [accordion] Já existe um pedido com este número neste workspace.
>
> O número do pedido é único no workspace, contando os pedidos da lixeira.
>
> **O que fazer:** troque por outro número. O formulário de pedido novo já
> vem com o próximo livre no padrão `PEV-0001`, contando a lixeira. Depois de
> salvo, o número não muda mais.

## Expedição

> [accordion] Sua empresa fatura antes de enviar: emita a NF-e do pedido, ou desligue a regra nas configurações de Pedidos
>
> Com **Faturar antes de enviar** ligado (Configurações › Pedidos de venda),
> o pedido só vai para a Expedição depois da NF-e. Se o pedido ainda não foi
> aprovado, a mensagem é "Aprove o pedido antes de enviar para a expedição".
>
> **O que fazer:** emita a NF-e do pedido (**Emitir NF-e**) e use **Enviar
> para a expedição**. Se a sua empresa não emite nota pelo Apex, desligue a
> regra.

> [accordion] A NF-e deste pedido não está autorizada: o pacote só sai com a nota
>
> Com **Faturar antes de enviar** ligado, o pacote só deixa a doca com a
> NF-e autorizada. Acontece quando a nota foi cancelada depois de o pedido
> chegar à doca. No despacho em lote, a frase vem com os números dos pedidos
> recusados; os outros saem normalmente.
>
> **O que fazer:** veja a pendência no pedido, corrija e emita a NF-e de
> novo. Autorizada a nota, despache.

> [accordion] Não foi possível despachar — Imprima a etiqueta antes
>
> O texto completo é "Imprima a etiqueta antes — sem ela a transportadora
> recusa o volume". No despacho em lote, os pedidos sem etiqueta ficam na
> doca e o aviso diz quantos.
>
> **O que fazer:** use **Imprimir etiqueta** na linha (ou **Imprimir
> etiquetas** na seleção) e despache de novo.

> [accordion] A etiqueta ainda não sai
>
> Nos envios do Mercado Envios, quem libera a etiqueta é o Mercado Livre. O
> aviso diz o motivo, por exemplo "O Mercado Livre libera a etiqueta depois
> de receber a NF-e deste pedido" ou a data em que ela será liberada. Na
> lista da Expedição, um alerta na coluna **Forma de frete** avisa antes de
> você tentar.
>
> **O que fazer:** se falta a nota, emita a NF-e; o Apex a envia ao canal
> sozinho. Se o canal recusou a nota, o motivo aparece no aviso: corrija e
> use **Enviar NF-e ao Mercado Livre** no menu do pedido. Venda Full não tem
> etiqueta no Apex: quem envia é o Mercado Livre.

## Nota de entrada

> [accordion] Vincule os itens ao catálogo antes de lançar o estoque (ou marque que não entram no estoque)
>
> A frase termina com os itens da nota que ainda não apontam para um produto
> do catálogo. Sem o vínculo, o Apex não sabe em que saldo pôr a mercadoria.
>
> **O que fazer:** use **Vincular produtos** no menu da nota e ligue cada item
> a um produto (ou crie o produto a partir do XML). Item que não é mercadoria
> de estoque pode ser marcado como fora do estoque. Depois, **Lançar
> estoque**. Veja [Notas de entrada](https://docs.apexx.work/compras/notas-de-entrada.md).

> [accordion] Informe o lote de Produto X na seção Lotes da nota antes de lançar o estoque
>
> O produto controla lote e validade, e toda entrada dele precisa dizer de
> qual lote é.
>
> **O que fazer:** abra a nota, preencha a seção **Lotes** com o número, a
> validade e a quantidade de cada lote, e use **Lançar estoque** de novo.

> [accordion] A nota 1234 já tem conta paga: desfaça o pagamento no financeiro antes
>
> Aparece em **Desfazer contas**. Cancelar as contas da nota com uma delas
> paga deixaria um pagamento sem conta.
>
> **O que fazer:** em **Financeiro › Contas a Pagar**, desfaça o pagamento da
> conta da nota. Depois use **Desfazer contas**.

## Devolução

> [accordion] Devolução já recebida, reembolsada ou trocada: a situação não volta atrás por edição. Use "Desfazer".
>
> Receber a mercadoria dá entrada no estoque, reembolsar lança o financeiro e
> concluir a troca cria o pedido de troca. Voltar a situação pelo formulário
> permitiria lançar tudo de novo.
>
> **O que fazer:** use o comando de volta no menu da devolução: **Desfazer
> recebimento** (a mercadoria sai do estoque, do mesmo depósito e lote),
> **Desfazer reembolso** (a conta a pagar do reembolso é cancelada e as
> contas a receber abatidas voltam ao valor de antes) ou **Desfazer troca**
> (o pedido de troca é cancelado). Cada um pede confirmação antes.

> [accordion] Devolução já reembolsada ou trocada: o valor e a forma de reembolso não mudam mais.
>
> O reembolso saiu com aquele valor e aquela forma: a conta a pagar e o
> abatimento nas contas a receber foram feitos com eles. Observações
> continuam editáveis.
>
> **O que fazer:** se o valor estava errado, use **Desfazer reembolso**,
> corrija e reembolse de novo.

> [accordion] O reembolso da devolução DEV-0001 já foi pago (conta CP-0001): desfaça o pagamento no financeiro antes
>
> Aparece em **Desfazer reembolso**: o dinheiro do reembolso já saiu do
> caixa, e cancelar a conta deixaria esse pagamento sem explicação.
>
> **O que fazer:** em **Financeiro › Contas a Pagar**, desfaça o pagamento da
> conta indicada. Depois use **Desfazer reembolso**.

> [accordion] O item "Produto X" não está ligado a um produto do catálogo
>
> Aparece em **Receber mercadoria**: o item está marcado para voltar ao
> estoque, mas não aponta para um produto do cadastro. Uma variante é "Há
> item avariado nesta devolução e nenhum depósito de avaria".
>
> **O que fazer:** vincule o item a um produto, ou desmarque a volta ao
> estoque dele. Para o item avariado, escolha o depósito de avaria em
> Configurações › Devoluções, ou desmarque "avariado".

> [accordion] Devolução com mercadoria lançada no estoque ou reembolso lançado não vai para a lixeira: ela é o registro desses lançamentos.
>
> A devolução é o registro da entrada no estoque e do reembolso (ou da
> troca). Sem ela, esses lançamentos ficariam sem explicação. Vale também
> para apagar de vez.
>
> **O que fazer:** desfaça antes o que foi lançado (**Desfazer recebimento**,
> **Desfazer reembolso** ou **Desfazer troca**). Devolução recusada, ou sem
> nada lançado, vai para a lixeira normalmente.

## Estoque

> [accordion] Organização sem depósito padrão configurado
>
> Nenhum depósito ativo está marcado como padrão, e o lançamento não sabe de
> onde tirar (ou onde pôr) a mercadoria.
>
> **O que fazer:** em **Configurações › Estoque › Depósitos**, abra um
> depósito e use **Tornar padrão**.

> [accordion] Físico de CAM-PRETA-M ficaria em 2 com 3 reservado e 0 bloqueado
>
> A saída deixaria no depósito menos do que já está reservado para pedidos
> (ou bloqueado). O Apex não deixa o físico ficar abaixo do que já tem dono.
>
> **O que fazer:** confira se a saída é mesmo deste depósito e desta
> variação. Se a mercadoria realmente não existe mais, cancele ou reabra o
> pedido que a reservou antes de lançar a saída.

> [accordion] Não dá para excluir "Produto X": ainda há 5 em estoque. Lance uma saída ou um ajuste para zerar o saldo antes de excluir.
>
> Excluir o cadastro esconderia um saldo que continua existindo no extrato. A
> frase diz o que segura o produto: o que está em estoque, reservado para
> pedido, bloqueado ou em trânsito.
>
> **O que fazer:** em **Suprimentos › Estoque**, zere o saldo com **Registrar
> saída** ou **Fazer balanço**, ou cancele o pedido que reservou. Se você só
> quer parar de usar o produto, mude o **Status** do cadastro para Inativo.

## Mercado Livre

> [accordion] A venda ainda não está paga no Mercado Livre: o estoque é reservado quando o canal confirmar o pagamento.
>
> Antes do pagamento a venda pode não se concretizar.
>
> **O que fazer:** aguarde. Com **Processar vendas do canal** ligado, o Apex
> reserva sozinho assim que o canal confirmar.

> [accordion] Vincule todos os produtos desta venda aos anúncios antes de reservar o estoque.
>
> Uma das linhas da venda aponta para um anúncio que não está ligado a
> nenhuma variação do seu cadastro — não há saldo a reservar. A venda fica
> com **Produto pendente**.
>
> **O que fazer:** em **Vendas › Anúncios**, vincule o anúncio ao produto (ou
> [crie o produto a partir dele](https://docs.apexx.work/integracoes/mercado-livre/produtos.md)) e use
> **Atualizar do Mercado Livre** no menu do pedido.

> [accordion] Defina o depósito do canal em Configurações → Integrações e atualize o pedido antes de reservar.
>
> Sem depósito escolhido não há de onde reservar.
>
> **O que fazer:** escolha o **Depósito do canal** nas configurações do
> Mercado Livre e use **Atualizar do Mercado Livre** no pedido.

> [accordion] A venda foi cancelada no Mercado Livre
>
> O canal cancelou. Ao reservar, a frase termina com "Cancele o pedido para
> liberar o estoque"; depois de aprovada, com "cancele o pedido em vez de
> seguir com ele".
>
> **O que fazer:** cancele o pedido para liberar o estoque. Com o
> processamento ligado, isso acontece sozinho. Se o canal cancelou depois de o
> pacote sair, o Apex abre uma devolução da venda, como Solicitada: o estoque
> volta quando você usar **Receber mercadoria** nela.

> [accordion] O envio foi cancelado no Mercado Livre. Confira a venda no canal antes de seguir.
>
> O envio foi cancelado mas a venda continua de pé — costuma significar troca
> de modalidade de frete.
>
> **O que fazer:** confira a venda no canal antes de seguir com o pedido.

> [accordion] Pedido importado do Mercado Livre: os dados vêm do canal. Use Reservar estoque, Despachar ou Cancelar para movimentá-lo.
>
> Você tentou editar um pedido de marketplace. Os dados são do canal e mudam
> lá.
>
> **O que fazer:** use os comandos do menu para movimentá-lo, ou
> **Atualizar do Mercado Livre** para reler o canal.

> [accordion] Reconecte a conta do Mercado Livre.
>
> A autorização expirou ou foi revogada no canal.
>
> **O que fazer:** em **Integrações**, use **Reconectar** na conta. Os
> anúncios, vínculos e pedidos já importados são preservados.

> [accordion] Importação em andamento ou execução expirada. Aguarde e retome.
>
> Outra importação da mesma conta está rodando — possivelmente em outra aba,
> ou o ciclo automático.
>
> **O que fazer:** aguarde um instante e retome. O progresso fica salvo.

> [accordion] Escolha até 31 dias, com a data final entre a inicial e hoje.
>
> A importação de vendas consulta no máximo 31 dias por vez, sem datas
> futuras.
>
> **O que fazer:** quebre o período em partes.

> [accordion] Escolha o depósito do canal antes de ligar o processamento das vendas.
>
> Sem depósito, as vendas entrariam sem ter de onde reservar.
>
> **O que fazer:** escolha o **Depósito do canal** e ligue **Processar vendas
> do canal** depois.

## Permissões

> [accordion] Você não tem permissão para executar esta ação neste módulo
>
> Seu acesso não cobre aquela ação naquela página. Na tela de permissões,
> **Visualizar** só consulta; **Operar** é o que libera criar, editar,
> excluir, exportar e os comandos — aprovar, despachar, lançar, receber.
>
> **O que fazer:** peça a quem administra o workspace, em
> **Configurações › Membros**.

> [accordion] Solicite alcance de dados completo
>
> Seu **Alcance dos dados** está em "Somente próprios", e a operação mexe em
> dados compartilhados do workspace — as configurações de um canal, os
> anúncios ou a importação de vendas do marketplace. A frase muda conforme a
> tela ("As configurações do canal são compartilhadas…").
>
> **O que fazer:** peça o alcance "Todos" a quem administra o workspace.

> [accordion] Registro não encontrado (mas eu sei que ele existe)
>
> Com o alcance "Somente próprios", um registro de outra pessoa responde como
> inexistente — de propósito, para não confirmar que ele existe.
>
> **O que fazer:** peça o alcance completo, ou peça a quem criou.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.