Pular para o conteúdo
Documentação do usuário

Turquia

Módulos

Os seguintes módulos são instalados automaticamente com a localização turca:

Name

Technical name

Description

Türkiye - Accounting

l10n_tr

Base Turkish fiscal localization package <fiscal_localizations/packages> complete with the Turkish chart of accounts, taxes, financial reports, and fiscal positions

Türkiye - Accounting Reports

l10n_tr_reports

Türkiye-specific tax and profit and loss reporting.

Türkiye - e-Irsaliye (e-Dispatch)

l10n_tr_nilvera_edispatch

Enables the generation and upload of e-Dispatch files

Além disso, os seguintes módulos devem ser instalados <general/install> manualmente para usar a localizations/turkiye/nilvera para gerenciar documentos eletrônicos:

Name

Technical name

Description

Türkiye - Nilvera

l10n_tr_nilvera

Integration module enabling communication with Nilvera and enabling the generation of e-Ledger files

Türkiye - Nilvera E-Invoice

l10n_tr_nilvera_einvoice

For sending and receiving basic scenario electronic invoices to/from Nilvera.

Türkiye - Nilvera E-Invoice Extended

l10n_tr_nilvera_einvoice_extended

Enhances the e-invoice module, enabling support for multiple invoice types and scenarios
Veja também:

Turkish Payroll localization documentation

Visão geral da localização

O pacote de localização turco garante conformidade com as regulamentações fiscais e contábeis turcas. Inclui ferramentas para gerenciar impostos, posições fiscais, relatórios e um plano de contas pré-definido adaptado aos padrões da Türkiye.

O pacote de localização turco oferece os seguintes recursos principais para garantir conformidade com as regulamentações fiscais e contábeis locais:

  • ../accounting/get_started/chart_of_accounts: a predefined structure tailored to Turkish accounting standards

  • localizations/turkiye/taxes: pre-configured tax rates, including standard VAT, zero-rated, and exempt options

  • ../accounting/taxes/fiscal_positions: automated tax adjustments based on customer or supplier registration status

  • localizations/turkiye/eds: integration with Nilvera to meet electronic document regulations

Plano de contas

No plano de contas, as contas são mapeadas automaticamente para seus impostos correspondentes e campos padrão de contas a pagar e contas a receber.

Impostos

Impostos são criados e configurados automaticamente quando a localização turca é instalada.

Soluções de documentos eletrônicos

A localização turca garante conformidade com os requisitos do GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)) para processos de nota fiscal eletrônica, arquivo eletrônico, despacho eletrônico e livro eletrônico.

Através da integração Nilvera, o Odoo permite a transmissão, recepção e gerenciamento automatizados de documentos eletrônicos de acordo com os padrões de documentos eletrônicos do GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)). As principais funcionalidades da integração Nilvera incluem:

  • creating and validating e-archives and e-invoices <localizations/turkiye/send> directly from Odoo

  • receiving and processing responses from Nilvera/GİB <localizations/turkiye/receive>

  • storing transmitted XML and PDF versions for auditing

  • creating and uploading e-dispatch XML to and from Nilvera <localizations/turkiye/dispatch>

Empresa e contatos

Antes de ativar a localização Türkiye, certifique-se de que as seguintes informações estão configuradas corretamente no registro de contato da sua empresa:

  • Company Name: Must match the GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)) registration

  • Turkish Tax Office: Registered tax office

  • Tax ID: VKN/TCKN - 10 digits for companies, 11 for individuals

  • Address: Complete legal address

  • Country: Registered country

  • Tags: Enter the Mersis number as a tag and set the Category to MERSISNO.

  • eInvoice format: Türkiye (UBL TR 1.2)

  • Alias: Alias acquired from Nilvera

Para cada cliente e fornecedor:

  • Ensure the Address, City, State, Country, Tax ID, and eInvoice format are configured.

  • If the partner is not registered for e-invoicing, Odoo automatically defaults to e-Archive.

Criação de impostos

Criar motivos de exceção

Para criar motivos de exceção adicionais, siga estas etapas:

  1. Enable developer mode <developer-mode> and navigate to Accounting --> Configuration › GIB Codes.

  2. Click the New button.

  3. Enter a Reason and a Reason Code that match the values in Nilvera's documentation.

  4. Select the corresponding code type:

    • Withholding for withholding tax reasons

    • Exception for tax-exempt reasons

    • Export exception for export exception reasons

    • Export registration for export-registered reasons

  5. For Withholding reasons, enter the corresponding percentage.

Criar impostos retidos na fonte

  1. Navigate to Accounting › Configuration › Taxes.

  2. Click the New button to first create the base tax.

  3. Set the Tax Computation to Percentage, and set the Withholding Tax Reason field that appears for taxes of this type.

  4. Complete the other mandatory fields of the form (Tax Name, Tax Type, Amount, etc.).

  5. Create additional taxes with Tax Computation set to Group of Taxes. These group taxes should be composed of the base tax created in the previous steps and additional percentage taxes.

Integração Nilvera

O Odoo se integra com a Nilvera, uma intermediária de documento eletrônico aprovada pela GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)), para gerenciar processos de nota fiscal eletrônica, arquivo eletrônico, despacho eletrônico e livro razão eletrônico.

A integração gerencia:

  • XML data generation in a GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı))-compliant format

  • secure transmission to Nilvera

  • synchronization of documents and statuses within Odoo.

Tipos de documentos suportados

  • e-Invoice

    • Basic scenario and public scenario

      • Sales

      • Withholding

      • Registered for export

      • Tax exempt

    • Export scenario

  • e-Archive invoice

    • Sales

    • Withholding

    • Registered for export

    • Tax exempt

  • e-Dispatch note

Configuração

A documentação da Nilvera fornece instruções para acessar o sandbox e gerar as credenciais da API.

Para configurar a integração Nilvera com seu banco de dados, siga estas etapas:

  1. Make sure the Türkiye - Nilvera module is installed <general/install>.

  2. Navigate to Accounting › Configuration › Settings and scroll to the Türkiye Electronic Integrations section.

  3. Configure:

    • Nilvera API credentials (generated in Nilvera)

    • Incoming Invoices Journal (i.e., Purchases)

Para configurar seus registros de contato de cliente para poder enviar e-faturas a eles via Nilvera, siga estas etapas:

  1. Navigate to Accounting › Customers › Customers.

  2. Remove the Customer Invoices filter (if necessary), and select the partner to contact via Nilvera.

  3. Open the Accounting tab and click Verify next to Nilvera Status.

Enviar e-Faturas via Nilvera

e-Invoice/e-Archive é um sistema de fatura digital aprovado pelo governo que substitui faturas tradicionais em papel, permitindo que empresas emitam, transmitam e armazenem faturas eletronicamente em conformidade com as regulamentações fiscais turcas. Enquanto e-Invoices são para clientes registrados no GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)), e-Archives podem ser enviados para clientes não registrados no GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)), garantindo que os remetentes possam cumprir as regulamentações governamentais mesmo ao lidar com clientes estrangeiros ou fluxos de trabalho B2C.

Para enviar uma e-Invoice/e-Archive, siga estas etapas:

  1. Make sure the Türkiye - Nilvera E-Invoice and Türkiye - Nilvera E-Invoice Extended modules are installed <general/install>.

  2. When creating a customer invoice <accounting/invoice/creation>, after selecting a Customer,

    • if the customer's Nilvera Status is e-Archive, two fields will appear:

      • Is GIB Export: used for product export invoices to partners outside of Türkiye

      • Invoice Type: determines the type of invoice

    • if the customer's Nilvera Status is e-Invoice, the Invoice Scenario field will appear: Select the scenario of the invoice to be sent to the GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)).

  3. Send <accounting/invoice/sending> the invoice, and ensure by Nilvera is selected to issue an e-invoice.

Receber e-Faturas via Nilvera

Atualizar status do Nilvera

Para atualizar o Status Nilvera das faturas no Odoo, siga estas etapas:

  1. Open the Accounting Dashboard.

  2. Click on the Sales journal.

  3. Click the fa-cog (Actions) icon, then click Refresh e-Invoices Status. This action updates the Nilvera Status field on each invoice.

Buscar PDFs de e-faturas

Existem dois métodos para buscar PDFs de e-faturas:

  1. From the invoice list view:

    1. Go to Accounting › Customers › Invoices.

    2. Select one or multiple invoices.

    3. Click the Fetch Nilvera PDF

  2. From an invoice form view: Once the Nilvera Status is Successful, click the Fetch Nilvera PDF button.

Receber e-faturas de compra

Para buscar e-faturas geradas no Nilvera e recebidas pela sua empresa:

  1. Open the Accounting Dashboard.

  2. Click on the Purchase journal.

  3. Click the fa-cog (Actions) icon, then click Fetch e-invoices. The received e-invoices are created as vendor bills in Draft status.

Buscar PDFs de faturas geradas no Odoo

Para contas a pagar que foram criadas no Odoo, a recuperação de PDF funciona da mesma forma que para faturas de cliente:

  1. Go to Accounting › Vendors › Bills.

  2. Select one or multiple vendor bills.

  3. Click the Fetch Nilvera PDF button.

Gerar e-Ledger

O e-Ledger é um sistema eletrônico que permite que as empresas armazenem digitalmente e enviem seus registros contábeis ao governo para conformidade fiscal e regulatória. No Odoo, os usuários podem gerar o e-Ledger como um arquivo CSV compactado e relatar registros da empresa perfeitamente através da integração Nilvera.

  1. Navigate to Accounting › Reporting › General Ledger.

  2. Click the fa-cog (Actions) icon.

  3. Click Generate e-Ledger to generate the file and download it to your computer.

Gerenciar arquivos de e-Dispatch

Gerar arquivos de e-Dispatch

O e-Dispatch é um documento eletrônico que substitui as tradicionais notas fiscais de entrega em papel, permitindo que as empresas emitam, transmitam e rastreiem digitalmente detalhes de remessas de mercadorias em trânsito. No Odoo, os usuários podem gerar documentos e-Dispatch em XML e enviá-los através da integração Nilvera, garantindo operações de entrega conformes e rastreáveis.

  1. Navigate to Inventory › Operations › Deliveries.

  2. Open an existing delivery order or create a new one.

  3. Once a Delivery Address is selected, fill in the necessary information in the e-Dispatch tab that appears.

  4. #. Once the delivery order is validated, click the Generate GİB e-Dispatch (XML) button that appears to generate the XML file.

  5. Download the generated file attached to the delivery order and upload it to Nilvera for processing.

Enviar arquivos de e-Dispatch

  1. Download the received e-Dispatch XML from Nilvera.

  2. Navigate to Inventory › Operations › Receipts.

  3. Click the Upload e-Receipt (XML) button and select the downloaded file.

Informações de conformidade obrigatória

As seguintes regras são obrigatórias para todos os usuários da integração de localização Türkiye. A conformidade com esses requisitos é essencial para a validade legal dos e-Documents emitidos através do GİB (Turkish Revenue Administration (Gelir İdaresi Başkanlığı)) via Nilvera.

Estrutura de numeração de documentos

  • All generated invoices and dispatch documents must follow a specific numbering structure: three alphanumeric characters + document year + sequential number.

  • The numbering must be unique, sequential, and continuous. Each document must have a distinct identifier.

  • Once a file has been submitted, even if it returns an error, the same sequence number cannot be used; a new document must be created.

Veja também:
Lacunas em números de sequência

  • If a sequence number is skipped, the previous missing numbers must be issued within 7 days.

  • No sequence number can remain unissued beyond this period.

Regras de desconto

  • Global discounts (discounts shown as a separate invoice line) cannot be issued.

  • All discounts must be applied at the product line level within the invoice.

Conformidade com e-Ledger

  • The first issued invoice must represent the opening balance for the accounting period.

  • All subsequent invoices must follow the sequential numbering pattern:

  • Sequential numbering must be maintained consistently across the e-Ledger to ensure data integrity and compliance.

Voltar ao índice
ON THIS PAGE