Turquía¶
Módulos¶
Los siguientes módulos se instalan de forma automática con la localización de Turquía:
Nombre |
Nombre técnico |
Descripción |
|---|---|---|
Turquía - Contabilidad |
|
El paquete de localización fiscal base para Turquía, que incluye el plan contable turco, impuestos, reportes financieros y posiciones fiscales. |
Turquía - Reportes contables |
|
Reportes fiscales y de estado de resultados específicos de Turquía. |
Turquía - e-Irsaliye (Guía de despacho digital) |
|
Permite generar y subir archivos de guías de despacho digitales (e-Dispatch). |
Además, debes instalar los siguientes módulos de forma manual para usar la Integración con Nilvera y gestionar documentos electrónicos:
Nombre |
Nombre técnico |
Descripción |
|---|---|---|
Turquía - Nilvera |
|
Módulo de integración que habilita la comunicación con Nilvera y la creación de archivos de libro electrónico. |
Turquía - Facturas electrónicas de Nilvera |
|
Para enviar y recibir facturas electrónicas básicas a y desde Nilvera. |
Turquía - Facturas electrónicas extendidas de Nilvera |
|
Agrega distintos elementos al módulo de facturación electrónica y ofrece soporte para varios tipos de factura y casos. |
Nota
Es posible que en algunos casos los módulos no se instalen en automático, por ejemplo, al actualizar a una versión con módulos adicionales. Instale los módulos faltantes de forma manual.
Resumen de la localización¶
El paquete de localización de Turquía asegura el cumplimiento de las normativas fiscales y contables turcas. Incluye herramientas para gestionar impuestos, posiciones fiscales, reportes y un plan de cuentas predefinido adaptado a las normas de Turquía.
El paquete de localización turca ofrece las siguientes funciones clave para garantizar el cumplimiento de las normativas fiscales y contables locales:
Plan de cuentas: Una estructura predefinida adaptada a las normas contables turcas.
Impuestos: Tasas impositivas preconfiguradas, incluido el IVA estándar, de tasa cero y excepciones.
Posiciones fiscales (mapeo de impuestos y cuentas): Ajustes automáticos de impuestos según el estado de registro del cliente o proveedor.
Soluciones para documentos electrónicos: Integración con Nilvera para cumplir con las normativas de los documentos electrónicos.
Plan de cuentas¶
En el plan de cuentas, el sistema vincula las cuentas de forma automática con sus respectivos impuestos y con los campos de cuentas por pagar y cuentas por cobrar de forma predeterminada.
Nota
El plan de cuentas de Turquía está basado en las cuentas 7/A de la Administración Tributaria de Turquía (Gelir İdaresi Başkanlığı (GİB)), que ofrecen una base de las cuentas necesarias. Las cuentas 7/B están archivadas y puedes desarchivarlas en caso de que las necesites.
Impuestos¶
El sistema crea y configura los impuestos de forma automática al instalar la localización turca.
Advertencia
No elimines los impuestos, ya que estos sirven para las facturas electrónicas y facturas de tipo e-archive. Sin embargo, puedes generar nuevos impuestos, como para motivos de retención que aún no existen en la base de datos.
Soluciones para documentos electrónicos¶
La localización turca asegura el cumplimiento de los requisitos de la GİB para los procesos de factura electrónica, e-archivo, guía de despacho electrónica y libro electrónico.
A través de la integración con Nilvera, Odoo permite la transmisión, recepción y gestión automatizadas de documentos electrónicos de acuerdo con las normas de los documentos electrónicos de la GİB. Las funciones principales de la integración con Nilvera incluyen:
Crear y validar archivos electrónicos y facturas electrónicas de forma directa desde Odoo
Almacenar versiones XML y PDF transmitidas para auditoría
Crear y subir XML de guías de despacho electrónicas a y desde Nilvera
Empresa y contactos¶
Antes de activar la localización de Turquía, asegúrate de que la siguiente información esté configurada de forma correcta en el registro de contacto de tu empresa:
Importante
Para acceder a todos estos campos, ve al registro de contacto de la empresa en la aplicación Contactos o dirígete a , elimina el filtro Facturas de cliente y selecciona el registro de contacto de la empresa. Esto no es lo mismo que acceder al registro de la empresa desde los ajustes generales.
Nombre de la empresa: Debe coincidir con el registro de la GİB.
Oficina fiscal turca: Oficina fiscal registrada.
Número de identificación fiscal: VKN/TCKN: 10 dígitos para empresas, 11 para personas físicas.
Dirección: Dirección legal completa.
País: País registrado.
Etiquetas: Ingresa el número Mersis como etiqueta y define la categoría como MERSISNO.
Formato de la factura electrónica: Turquía (UBL TR 1.2).
Alias: Alias obtenido de Nilvera.
Nota
El campo Formato de la factura electrónica se define de forma automática según el país del contacto. Para editar este campo, activa el modo de desarrollador para visualizarlo y luego modifícalo de forma manual.
El campo Alias solo aparece cuando el estado de Nilvera de la empresa es Factura electrónica.
Para cada cliente y proveedor:
Asegúrate de que los campos Dirección, Ciudad, Estado, País, Número de identificación fiscal y Formato de la factura electrónica estén configurados.
Si el contacto no está registrado para facturación electrónica, Odoo usará el archivo electrónico de forma predeterminada.
Creación de impuestos¶
Crear motivos de excepción¶
Sigue estos pasos para crear motivos de excepción adicionales:
Activa el modo de desarrollador y ve a .
Haz clic en el botón Nuevo.
Ingresa un motivo y un código de motivo que coincidan con los valores de la documentación de Nilvera.
Selecciona el tipo de código correspondiente:
Retención para motivos de retención.
Excepción para motivos de exención fiscal.
Excepción de exportación para motivos de excepción de exportación.
Registro de exportación para motivos de registro de exportación.
Para los motivos de retención, ingresa el porcentaje correspondiente.
Crear impuestos de retención¶
Ve a .
Primero haz clic en el botón Nuevo para crear el impuesto base.
Configura el cálculo de impuestos con la opción Porcentaje y define el campo Motivo de retención que aparece para los impuestos de este tipo.
Completa el resto de los campos obligatorios del formulario (Nombre del impuesto, Tipo de impuesto, Importe, entre otros).
Crea impuestos adicionales con el cálculo de impuestos configurado con la opción Grupo de impuestos. Estos impuestos de grupo deben incluir el impuesto base creado en los pasos anteriores y otros impuestos porcentuales.
Truco
El impuesto WH 20% muestra esta configuración. Para usar un motivo de retención distinto, duplica el impuesto base, actualiza el motivo y reemplaza el impuesto base anterior en los impuestos de grupo duplicados.
Integración con Nilvera¶
Odoo se integra con Nilvera, un intermediario de documentos electrónicos aprobado por la GİB, para gestionar los procesos de factura electrónica, archivo electrónico, guía de remisión electrónica y libro electrónico.
La integración gestiona:
Generación de datos XML en un formato compatible con la GİB
Transmisión segura a Nilvera
Sincronización de documentos y estados dentro de Odoo.
Tipos de documentos compatibles¶
Factura electrónica
Escenario básico y escenario público
Ventas
Retenciones
Registrado para exportación
Exento de impuestos
Escenario de exportación
Factura de archivo electrónico
Ventas
Retenciones
Registrado para exportación
Exento de impuestos
Guía de despacho electrónica
Configuración¶
La documentación de Nilvera incluye las instrucciones para acceder al entorno de prueba y generar las credenciales de la API.
Sigue estos pasos para configurar la integración con Nilvera en tu base de datos:
Asegúrate de que el módulo Turquía - Nilvera esté instalado.
Ve a y dirígete a la sección Integraciones electrónicas de Turquía.
Configura lo siguiente:
Credenciales de la API de Nilvera (generadas en Nilvera)
Diario de facturas entrantes (por ejemplo, Compras)
Sigue estos pasos para configurar los registros de contacto de tus clientes y poder enviarles facturas electrónicas a través de Nilvera:
Ve a .
Elimina el filtro Facturas de cliente (en caso de que sea necesario) y selecciona el contacto que usarás con Nilvera.
Abre la pestaña Contabilidad y haz clic en Verificar junto a Estado de Nilvera.
Envío de facturas electrónicas con Nilvera¶
La factura electrónica y el archivo electrónico son sistemas de facturación digital aprobados por el gobierno que reemplazan las facturas en papel tradicionales y permiten emitir, enviar y almacenar facturas de forma electrónica en cumplimiento con la normativa fiscal turca. Las facturas electrónicas se usan con clientes registrados en la GİB, mientras que el archivo electrónico se envía a los clientes que no están registrados en la GİB, lo que permite cumplir la normativa incluso en operaciones con clientes extranjeros o flujos B2C.
Sigue estos pasos para enviar una factura electrónica o un archivo electrónico:
Asegúrate de que los módulos Turquía - Factura electrónica de Nilvera y Turquía - Factura electrónica extendida de Nilvera estén instalados.
Al crear una factura de cliente, después de seleccionar un cliente,
si el estado de Nilvera del cliente es archivo electrónico, aparecen dos campos:
Es exportación GIB: se usa para facturas de exportación de productos a contactos fuera de Turquía
Tipo de factura: define el tipo de factura
si el estado de Nilvera del cliente es factura electrónica, aparece el campo Escenario de la factura y deberás elegir el escenario de la factura que enviarás a la GİB.
Envía la factura y asegúrate de seleccionar Por Nilvera para emitir una factura electrónica.
Recibir facturas electrónicas a través de Nilvera¶
Actualizar el estado de Nilvera¶
Sigue estos pasos para actualizar el estado de Nilvera de las facturas en Odoo:
Abre el tablero de contabilidad.
Haz clic en el diario de ventas.
Haz clic en el icono (Acciones) y luego en Actualizar estado de facturas electrónicas. Esta acción actualiza el campo Estado de Nilvera de cada factura.
Obtener los PDF de facturas electrónicas¶
Existen dos métodos para obtener los PDF de las facturas electrónicas:
Desde la vista de lista de las facturas:
Ve a .
Selecciona una o varias facturas.
Haz clic en Obtener PDF de Nilvera
Desde el formulario de una factura: Cuando el estado de Nilvera sea Correcto, haz clic en el botón Obtener PDF de Nilvera.
Recibir facturas electrónicas de compra¶
Para obtener las facturas electrónicas generadas en Nilvera y recibidas por tu empresa:
Abre el tablero de contabilidad.
Haz clic en el diario de compras.
Haz clic en el icono (Acciones) y luego en Obtener facturas electrónicas. El sistema creará las facturas recibidas como facturas de proveedor en estado de borrador.
Obtener PDF de facturas de proveedor creadas en Odoo¶
Para las facturas de proveedor creadas en Odoo, la obtención del PDF funciona de la misma manera que para las facturas de cliente:
Ve a .
Selecciona una o varias facturas de proveedor.
Haz clic en el botón Obtener PDF de Nilvera.
Generar libro electrónico¶
El libro electrónico es un sistema que permite a las empresas almacenar y presentar sus registros contables de forma digital ante el gobierno para cumplir con los requisitos fiscales y normativos. En Odoo, los usuarios pueden generar el libro electrónico como un archivo CSV comprimido y reportar los registros de la empresa a través de la integración de Nilvera.
Ve a .
Haz clic en el icono (Acciones).
Haz clic en Generar libro electrónico para crear el archivo y descargarlo en tu equipo.
Gestionar archivos de guía de remisión electrónica¶
Generar archivos de guía de remisión electrónica¶
La guía de remisión electrónica es un documento digital que reemplaza las guías de remisión en papel y permite emitir, enviar y rastrear los datos de envío de los bienes en tránsito. En Odoo, los usuarios pueden generar documentos de guía de remisión electrónica como XML y cargarlos a través de la integración de Nilvera, lo que asegura operaciones de entrega trazables y conformes a la normativa.
Ve a .
Abre una orden de entrega existente o crea una nueva.
Luego de seleccionar una dirección de entrega, completa la información necesaria en la pestaña Guía de remisión electrónica que aparece.
Después de validar la orden de entrega, haz clic en el botón Generar guía de remisión electrónica de GİB (XML) que aparece para generar el archivo XML.
Descarga el archivo generado adjunto a la orden de entrega y súbelo a Nilvera para su procesamiento.
Subir archivos de guía de remisión electrónica¶
Descarga el XML de la guía de remisión electrónica obtenido de Nilvera.
Ve a .
Haz clic en el botón Subir recibo electrónico (XML) y selecciona el archivo descargado.
Información obligatoria de cumplimiento¶
Las siguientes reglas son obligatorias para todos los usuarios de la localización de Turquía. El cumplimiento de estos requisitos garantiza la validez legal de los documentos electrónicos emitidos a través de la GİB mediante Nilvera.
Estructura de numeración de documentos¶
Todas las facturas y documentos de guía de remisión generados deben seguir una estructura de numeración específica:
tres caracteres alfanuméricos+año del documento+número secuencial.Example
INV/2025/00001
La numeración debe ser única, secuencial y continua. Además, cada documento debe tener un identificador distinto.
Una vez que envías un archivo, aunque devuelva un error, no puedes usar el mismo número de secuencia. Debes crear un nuevo documento.
Saltos en la numeración secuencial¶
Si omites un número de secuencia deberás emitir los números faltantes dentro de un plazo de 7 días.
Example
Si emites INV/2025/00002 antes de INV/2025/00001, debes emitir INV/2025/00001 dentro de los siguientes 7 días.
No puede existir ningún número de secuencia sin emitir después de este plazo.
Reglas de descuento¶
No puedes emitir descuentos globales (descuentos mostrados como una línea de factura separada).
Aplica todos los descuentos a nivel de línea de producto dentro de la factura.
Cumplimiento del libro electrónico¶
La primera factura emitida debe representar el saldo inicial del periodo contable.
Todas las facturas posteriores deben seguir el patrón de numeración secuencial:
Example
INV/2025/00001, INV/2025/00002, INV/2025/00003, etc.
Debes mantener la numeración secuencial de forma uniforme en todo el libro electrónico para asegurar la integridad de los datos y el cumplimiento normativo.