Turquía¶
Módulos¶
Los siguientes módulos se instalan automáticamente con la localización turca:
Nombre |
Nombre técnico |
Descripción |
|---|---|---|
Turquía - Contabilidad |
|
Paquete de localización fiscal base turco completo con el plan de cuentas turco, impuestos, informes financieros y posiciones fiscales |
Turquía - Informes contables |
|
Informes de impuestos y pérdidas y ganancias específicos de Turquía. |
Turquía - e-Irsaliye (e-Dispatch) |
|
Permite la generación y carga de archivos e-Dispatch |
Además, los siguientes módulos deben instalarse manualmente para usar el Integración con Nilvera para gestionar documentos electrónicos:
Nombre |
Nombre técnico |
Descripción |
|---|---|---|
Turquía - Nilvera |
|
Módulo de integración que permite la comunicación con Nilvera y la generación de archivos e-Ledger |
Turquía - Nilvera E-Invoice |
|
Para enviar y recibir facturas electrónicas de escenario básico a/desde Nilvera. |
Turquía - Nilvera E-Invoice Extended |
|
Mejora el módulo de factura electrónica, permitiendo soporte para múltiples tipos de factura y escenarios |
Nota
En algunos casos, como al actualizar a una versión con módulos adicionales, es posible que los módulos no se instalen automáticamente. Cualquier módulo faltante puede instalarse manualmente.
Descripción general de la localización¶
El paquete de localización turca garantiza el cumplimiento de las regulaciones fiscales y contables turcas. Incluye herramientas para gestionar impuestos, posiciones fiscales, informes y un plan de cuentas predefinido adaptado a los estándares de Turquía.
El paquete de localización turca proporciona las siguientes características clave para garantizar el cumplimiento de las regulaciones fiscales y contables locales:
Plan contable: una estructura predefinida adaptada a los estándares contables turcos
Impuestos: tipos impositivos preconfigurados, incluyendo IVA estándar, tipo cero y opciones exentas
Posiciones fiscales (mapeo de impuestos y cuentas): ajustes fiscales automatizados basados en el estado de registro del cliente o proveedor
Soluciones de documentos electrónicos: integración con Nilvera para cumplir con las regulaciones de documentos electrónicos
Plan contable¶
En el plan de cuentas, las cuentas se asignan automáticamente a sus impuestos correspondientes y a los campos predeterminados de cuentas por pagar y cuentas por cobrar.
Nota
El plan de cuentas de Turquía se basa en las cuentas 7/A de la Administración Tributaria Turca (Gelir İdaresi Başkanlığı (GİB)), que proporcionan una base de las cuentas necesarias. Las cuentas 7/B están archivadas y pueden desarchivarse si es necesario.
Impuestos¶
Impuestos se crean y configuran automáticamente cuando se instala la localización turca.
Advertencia
No elimines impuestos, ya que se utilizan para facturas electrónicas y facturas de archivo electrónico. Sin embargo, se pueden generar nuevos impuestos, como para razones de retención de impuestos que aún no existan en la base de datos.
Soluciones de documentos electrónicos¶
La localización turca garantiza el cumplimiento de los requisitos de GİB para los procesos de factura electrónica, archivo electrónico, despacho electrónico y libro mayor electrónico.
A través de la integración de Nilvera, Odoo permite la transmisión, recepción y gestión automatizadas de documentos electrónicos de acuerdo con los estándares de documentos electrónicos de GİB. Las principales funcionalidades de la integración de Nilvera incluyen:
crear y validar archivos electrónicos y facturas electrónicas directamente desde Odoo
almacenar versiones XML y PDF transmitidas para auditoría
crear y cargar XML de despacho electrónico hacia y desde Nilvera
Empresa y contactos¶
Antes de activar la localización de Türkiye, asegúrate de que la siguiente información esté configurada correctamente 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 yendo a , eliminando el filtro Facturas de clientes y seleccionando el registro de contacto de la empresa. Esto es diferente de acceder al registro de la empresa a través de la configuración general.
Nombre de la empresa: debe coincidir con el registro de GİB
Oficina tributaria turca: oficina tributaria registrada
ID fiscal: VKN/TCKN - 10 dígitos para empresas, 11 para particulares
Dirección: dirección legal completa
País: país registrado
Etiquetas: introduce el número Mersis como etiqueta y establece la categoría en MERSISNO.
Formato de factura electrónica: Türkiye (UBL TR 1.2)
Alias: alias adquirido de Nilvera
Nota
El formato de factura electrónica se establece automáticamente según el país del contacto. Para editar este campo, activa el modo de desarrollador para mostrar el campo y luego ajústalo manualmente.
El campo Alias solo es visible una vez que el estado de Nilvera de la empresa es Factura electrónica.
Para cada cliente y proveedor:
Asegúrate de que la dirección, la ciudad, el estado, el país, el NIF y el formato de factura electrónica estén configurados.
Si el contacto no está registrado para la facturación electrónica, Odoo usa automáticamente e-Archive de forma predeterminada.
Creación de impuestos¶
Crear motivos de excepción¶
Para crear motivos de excepción adicionales, sigue estos pasos:
Activa el modo de desarrollador y ve a .
Haz clic en el botón Nuevo.
Introduce 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 de impuestos
Excepción para motivos de exención de impuestos
Excepción de exportación para motivos de excepción de exportación
Registro de exportación para motivos registrados de exportación
Para motivos de retención, introduce el porcentaje correspondiente.
Crear impuestos de retención¶
Ve a .
Haz clic en el botón Nuevo para crear primero el impuesto base.
Establece el cálculo del impuesto en porcentaje y configura el campo motivo del impuesto de retención que aparece para los impuestos de este tipo.
Completa los otros campos obligatorios del formulario (Nombre del impuesto, Tipo de impuesto, Importe, etc.).
Crea impuestos adicionales con Cálculo de impuestos establecido en Grupo de impuestos. Estos grupos de impuestos deben estar compuestos por el impuesto base creado en los pasos anteriores y los impuestos porcentuales adicionales.
Truco
El impuesto WH 20% ilustra esta configuración. Para usar un motivo de retención diferente, duplica el impuesto base, actualiza el motivo y reemplaza el antiguo impuesto base en los grupos de impuestos duplicados.
Integración con Nilvera¶
Odoo se integra con Nilvera, un intermediario de documentos electrónicos aprobado por GİB, para gestionar los procesos de factura electrónica, archivo electrónico, envío electrónico y libro mayor electrónico.
La integración gestiona:
Generación de datos XML en un formato compatible con GİB
transmisión segura a Nilvera
sincronización de documentos y estados dentro de Odoo.
Tipos de documentos admitidos¶
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
Nota de envío electrónico
Configuración¶
La documentación de Nilvera proporciona instrucciones para acceder al entorno de pruebas y generar las credenciales de API.
Para configurar la integración con Nilvera en tu base de datos, sigue estos pasos:
Asegúrate de que el módulo Turquía - Nilvera esté instalado.
Ve a y desplázate hasta la sección Integraciones electrónicas de Türkiye.
Configurar:
Credenciales de API de Nilvera (generadas en Nilvera)
Diario de facturas de entrada (p. ej., Compras)
Para configurar los registros de contacto de tus clientes y poder enviarles facturas electrónicas a través de Nilvera, sigue estos pasos:
Ve a .
Elimina el filtro Facturas de cliente (si es necesario) y selecciona el contacto con el que comunicarse a través de Nilvera.
Abre la pestaña Contabilidad y haz clic en Verificar junto a Estado de Nilvera.
Enviar facturas electrónicas a través de Nilvera¶
La factura electrónica/archivo electrónico es un sistema de facturación digital aprobado por el gobierno que reemplaza las facturas en papel tradicionales, permitiendo a las empresas emitir, transmitir y almacenar facturas electrónicamente en cumplimiento de las regulaciones fiscales turcas. Mientras que las facturas electrónicas son para clientes registrados en GİB, los archivos electrónicos se pueden enviar a clientes no registrados en GİB, lo que garantiza que los remitentes puedan cumplir con las regulaciones gubernamentales incluso al tratar con clientes extranjeros o flujos de trabajo B2C.
Para enviar una factura electrónica/archivo electrónico, sigue estos pasos:
Asegúrate de que los módulos Türkiye - Factura electrónica Nilvera y Türkiye - Factura electrónica Nilvera extendida 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, aparecerán dos campos:
Es exportación GIB: se utiliza para facturas de exportación de productos a socios fuera de Türkiye
Tipo de factura: determina el tipo de factura
si el Estado de Nilvera del cliente es Factura electrónica, aparecerá el campo Escenario de factura: selecciona el escenario de la factura que se enviará a GİB.
Envía la factura y asegúrate de que esté seleccionado por Nilvera para emitir una factura electrónica.
Recibir facturas electrónicas a través de Nilvera¶
Actualizar estado de Nilvera¶
Para actualizar el estado de Nilvera de las facturas en Odoo, sigue estos pasos:
Abre el tablero de Contabilidad.
Haz clic en el diario 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 en cada factura.
Obtener PDF de facturas electrónicas¶
Hay dos métodos para obtener los PDF de las facturas electrónicas:
Desde la vista de lista de facturas:
Ve a .
Selecciona una o varias facturas.
Haz clic en Obtener PDF de Nilvera
Desde la vista de formulario de una factura: Una vez que el estado de Nilvera sea Exitoso, 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 Compra.
Haz clic en el icono (Acciones) y luego en Obtener facturas electrónicas. Las facturas electrónicas recibidas se crean como facturas de proveedor en estado Borrador.
Obtener PDF de facturas generadas en Odoo¶
Para las facturas de proveedor que se crearon 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 e-Ledger¶
El e-Ledger es un sistema electrónico que permite a las empresas almacenar digitalmente y enviar sus registros contables al gobierno para el cumplimiento fiscal y regulatorio. En Odoo, los usuarios pueden generar el e-Ledger como un archivo CSV comprimido y reportar los registros de la empresa sin problemas a través de la integración con Nilvera.
Navega a .
Haz clic en el icono (Acciones).
Haz clic en Generar e-Ledger para generar el archivo y descargarlo a tu ordenador.
Gestionar archivos e-Dispatch¶
Generar archivos e-Dispatch¶
El e-Dispatch es un documento electrónico que reemplaza los albaranes de entrega tradicionales en papel, permitiendo a las empresas emitir, transmitir y rastrear digitalmente los detalles de envío de mercancías en tránsito. En Odoo, los usuarios pueden generar documentos e-Dispatch como XML y subirlos a través de la integración con Nilvera, garantizando operaciones de entrega conformes y rastreables.
Navega a .
Abre un albarán de salida existente o crea uno nuevo.
Una vez seleccionada una Dirección de entrega, completa la información necesaria en la pestaña e-Dispatch que aparece.
#. Once the delivery order is validated, click the Generate GİB e-Dispatch (XML) button that appears to generate the XML file.
Descarga el archivo generado adjunto al albarán de salida y súbelo a Nilvera para su procesamiento.
Subir archivos e-Dispatch¶
Descarga el e-Dispatch XML recibido de Nilvera.
Navega a .
Haz clic en el botón Subir e-Receipt (XML) y selecciona el archivo descargado.
Información de cumplimiento obligatoria¶
Las siguientes reglas son obligatorias para todos los usuarios de la integración de localización de Turquía. El cumplimiento de estos requisitos es esencial para la validez legal de los e-Documents emitidos a través del GİB mediante Nilvera.
Estructura de numeración de documentos¶
Todas las facturas generadas y los documentos de envío 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. Cada documento debe tener un identificador distinto.
Una vez que se ha enviado un archivo, incluso si devuelve un error, no se puede usar el mismo número de secuencia; se debe crear un nuevo documento.
Huecos en el número secuencial¶
Si se omite un número de secuencia, los números anteriores faltantes deben emitirse dentro de los 7 días.
Example
Si se emite INV/2025/00002 antes de INV/2025/00001, INV/2025/00001 debe emitirse dentro de los 7 días.
Ningún número de secuencia puede quedar sin emitir más allá de este período.
Reglas de descuento¶
No se pueden emitir descuentos globales (descuentos mostrados como una línea de factura separada).
Todos los descuentos deben aplicarse a nivel de línea de producto dentro de la factura.
Cumplimiento del e-Ledger¶
La primera factura emitida debe representar el saldo de apertura para el período contable.
Todas las facturas subsiguientes deben seguir el patrón de numeración secuencial:
Example
INV/2025/00001, INV/2025/00002, INV/2025/00003, etc.
La numeración secuencial debe mantenerse de manera consistente en todo el e-Ledger para garantizar la integridad de los datos y el cumplimiento.