| Objetivo | Configurar a fiscalização KSeF da Polônia no PMS da Cloudbeds para que as faturas de empresas elegíveis possam ser enviadas ao KSeF. |
| Ideal para | Administradores do estabelecimento na Polônia responsáveis pela configuração da fiscalização. |
| Use quando | Você estiver preparando um estabelecimento polonês para usar a conexão de fiscalização KSeF no Cloudbeds. |
| Requisitos | Informações legais e fiscais do estabelecimento, certificado KSeF e chave privada, senha do certificado, configuração de impostos e formas de pagamento. |
| Resultado esperado | A configuração necessária de registro, certificado, código fiscal e formas de pagamento estará completa para a fiscalização na Polônia. |
| Limitações | O estabelecimento deve obter seu certificado KSeF e chave privada fora do Cloudbeds. Cloudbeds e Invopop não podem emitir, verificar ou redefinir esses itens. |
Introdução
Antes que um estabelecimento na Polônia possa enviar faturas de empresas elegíveis ao KSeF, a conexão KSeF da Polônia deve ser configurada no PMS da Cloudbeds. A configuração inclui registrar as informações legais e fiscais do estabelecimento, carregar seu certificado KSeF e mapear os códigos fiscais e formas de pagamento do estabelecimento.
O Cloudbeds conecta-se ao KSeF por meio do Invopop. O estabelecimento é responsável por obter seu certificado KSeF e chave privada no portal KSeF antes de concluir a configuração no Cloudbeds.
Se você precisar primeiro de uma explicação sobre o modelo de emissão fiscal da Polônia, os tipos de documentos suportados e quais faturas são enviadas ao KSeF, revise a Visão geral da emissão fiscal KSeF na Polônia.
Complete a configuração na ordem mostrada neste artigo. O registro deve ser concluído antes que o certificado KSeF possa ser carregado.
Neste artigo
- Antes de começar
- Abra as configurações de emissão fiscal da Polônia
- Conclua o registro
- Carregue o certificado KSeF
- Mapeie os códigos de imposto
- Mapeie as formas de pagamento
- Revise moedas e personalização
- Solução de problemas da configuração KSeF na Polônia
Antes de começar
Reúna as informações legais de registro do estabelecimento e as credenciais do KSeF antes de iniciar a configuração. O certificado KSeF, a chave privada e a senha são criados fora do Cloudbeds.
| Item | O que você precisa | Obrigatório |
|---|---|---|
| Razão social da empresa | Nome comercial registrado do estabelecimento. | Sim |
| NIP | Identificação fiscal polonesa de 10 dígitos. | Sim |
| REGON | Número de registro comercial polonês de 9 ou 14 dígitos. | Sim |
| KRS | Número de registro judicial polonês de 10 dígitos, quando a entidade possuir. | Se aplicável |
| Endereço comercial | Rua, cidade, voivodia, código postal e país. | Sim |
| E-mail de contato | Pelo menos um endereço de e-mail. | Sim |
| Certificado KSeF | Arquivo de certificado gerado pelo portal KSeF. Os formatos de arquivo suportados são .pem, .cer e .crt. | Sim |
| Chave privada | Chave privada gerada com o certificado. Os formatos de arquivo suportados são .pem e .key. | Sim |
| Senha do certificado | Senha definida quando o certificado foi gerado. | Sim |
Antes de gerar o certificado: Certifique-se de que ele possui as permissões InvoiceRead e InvoiceWrite no KSeF. Sem essas permissões, o envio da fatura pode falhar mesmo que o certificado tenha sido carregado com sucesso.
Abra as configurações de emissão fiscal da Polônia
Use as configurações de Emissão Fiscal no PMS da Cloudbeds para acessar a configuração do KSeF da Polônia do estabelecimento.
- Abra Conta
e vá para Configurações > Emissão Fiscal.
- Encontre o parceiro fiscal da Polônia e abra a conexão Invopop · KSeF.
A página de Emissão Fiscal mostra o provedor ativo da Polônia e os tipos de documentos fiscais roteados pelo Invopop.
Complete o cadastro
A guia Cadastro identifica a empresa que emitirá os documentos fiscais. Complete esta guia antes de carregar o certificado KSeF.
Insira as informações do estabelecimento nos campos de Cadastro:
| Campo | O que inserir |
|---|---|
| Razão social | O nome comercial completo registrado. |
| Identificação fiscal / Número VAT | O NIP de 10 dígitos do estabelecimento. |
| REGON | O REGON do estabelecimento com 9 ou 14 dígitos. |
| KRS | O KRS de 10 dígitos, se a entidade possuir. |
| Rua e Número | O endereço registrado da rua. |
| Cidade | A cidade registrada. |
| Voivodia | A região administrativa polonesa. |
| Código Postal | O código postal no formato XX-XXX. |
| País | PL. |
| Endereço de E-mail | Pelo menos um endereço de e-mail para contato. |
O NIP e o REGON são validados por soma de verificação. Se algum dos valores for rejeitado, insira o número exatamente como emitido, sem espaços ou traços.
A guia Registro mostra as informações da empresa, endereço registrado e e-mail de contato armazenados para a conexão de fiscalização da Polônia.
Carregue o certificado KSeF
Após concluir o Registro, use a guia Certificado para adicionar as credenciais que a Cloudbeds usa para autenticar as submissões ao KSeF.
Carregue os três itens obrigatórios:
| Campo | O que carregar |
|---|---|
| Certificado KSeF | O arquivo do certificado gerado pelo portal KSeF (.pem, .cer ou .crt). |
| Chave Privada | A chave privada gerada com o certificado (.pem ou .key). |
| Senha do Certificado | A senha criada quando o certificado foi gerado. |
Complete o cadastro primeiro. O certificado deve estar vinculado a uma parte registrada existente. Se o cadastro estiver incompleto, o carregamento pode falhar com a mensagem de que nenhum registro Invopop foi encontrado para o estabelecimento.
A Polônia autentica as submissões KSeF com o certificado. Não há uma etapa separada de nome de usuário e senha KSeF nesta configuração.
A guia Certificado contém a seção Autenticação onde o certificado KSeF, a chave privada e a senha do certificado são adicionados.
Mapear códigos fiscais
Use a guia Códigos fiscais para mapear as alíquotas de VAT configuradas no estabelecimento para as categorias fiscais governamentais usadas na fiscalização da Polônia.
As faixas padrão de VAT polonesas documentadas para esta conexão são:
- Geral: 23%
- Reduzida: 8%
- Super reduzida: 5%
Confirme que cada alíquota fiscal do estabelecimento está mapeada para a categoria governamental apropriada antes de concluir a configuração.
Linhas isentas de VAT são tratadas automaticamente. As informações de isenção exigidas para a Polônia são adicionadas pelo sistema e não são configuradas por estabelecimento.
A guia Códigos fiscais mostra as alíquotas de VAT do estabelecimento e a categoria fiscal governamental selecionada para cada uma.
Mapear formas de pagamento
Cada forma de pagamento usada pelo estabelecimento deve ser mapeada na guia Formas de Pagamento. Uma fatura contendo uma forma de pagamento que não foi mapeada não pode ser enviada com sucesso.
Mapeie cada forma de pagamento do estabelecimento para um dos códigos fiscais de pagamento suportados na Polônia:
| Código fiscal de pagamento | Etiqueta polonesa |
|---|---|
| dinheiro | Gotówka |
| cartão | Karta |
| outro+voucher | Bon |
| cheque | Czek |
| outro+crédito | Kredyt |
| transferência bancária | Przelew |
| on-line | Mobilna |
Não existe um pareamento universal entre forma de pagamento do estabelecimento e código fiscal. Mapeie cada forma de pagamento conforme a configuração do estabelecimento, em vez de assumir o código correto pelo nome da forma de pagamento.
A guia Formas de Pagamento lista as formas de pagamento disponíveis no estabelecimento e permite que você selecione o tipo fiscal correspondente para cada uma.
Revisar moedas e personalização
As guias Moedas e Personalização não exigem a mesma configuração que Registro, Certificado, Códigos de imposto e Formas de pagamento.
Moedas
Não é necessária configuração de moeda para a Polônia. PLN é a moeda do estabelecimento usada para a conexão de emissão fiscal na Polônia e está sempre disponível nesta tela.
A guia Moedas mostra o Zloty Polonês (PLN) como a moeda do estabelecimento e a moeda padrão.
Personalização
A guia Personalização é opcional. A Cloudbeds aplica configurações padrão do modelo de fatura, mas o estabelecimento pode usar esta guia para configurar opções suportadas do modelo, como o logotipo da fatura, altura e posicionamento do logotipo, localidade, formato de data, layout, cor da marca e fonte.
A guia Personalização contém as Configurações de Marca e de Documento usadas para ajustar a aparência dos documentos fiscais.
Solução de problemas na configuração do KSeF na Polônia
Use estas verificações quando o estabelecimento não conseguir concluir o registro, carregar seu certificado ou enviar uma fatura devido a uma dependência de configuração.
NIP ou REGON rejeitado
O NIP e o REGON utilizam validação por soma de verificação. Insira o número exatamente como foi emitido, sem espaços ou traços. Uma rejeição indica que os dígitos inseridos não passaram na validação.
Upload do certificado indica que nenhum registro foi encontrado
Complete a guia Registro antes de carregar o certificado. O certificado deve estar vinculado a uma parte registrada existente.
Envio ao KSeF retorna 403 Proibido
Confirme que o certificado pertence à conta da empresa e possui as permissões InvoiceRead e InvoiceWrite no portal KSeF. Se necessário, atualize as permissões do certificado ou emita um novo certificado autorizado.
Uma forma de pagamento não está configurada para a emissão fiscal
Acesse Conta > Configurações > Emissão Fiscal, abra a conexão Invopop · KSeF e selecione a guia Formas de Pagamento. Faça o mapeamento da forma de pagamento do estabelecimento que estiver faltando para o código fiscal polonês apropriado. Uma forma de pagamento não mapeada bloqueia o envio da fatura que utiliza essa forma de pagamento.
Upload do certificado indica que não está configurado para o país
Essa configuração não pode ser corrigida nas configurações do estabelecimento. Entre em contato com o Suporte da Cloudbeds.
Antes de contatar o Suporte, reúna o nome ou ID do estabelecimento, a mensagem de erro exata, o passo em que o erro aparece e o que você já tentou.
Próximo passo
Após concluir a configuração do KSeF para a Polônia, continue para Emitir faturas com emissão fiscal KSeF da Polônia para revisar as informações do destinatário necessárias para cada cenário de fatura e entender quando os documentos são enviados ao KSeF.
Comentários
Por favor, entre para comentar.