Oracle Financials Cloud

Solución local en la nube para América Latina

Colombia

Documento electrónico de sujetos no

obligados a facturar

Guía de implementación técnica

Versión 1

27 abr 2021

DESCARGO DE RESPONSABILIDAD:

Esta guía puede contener capturas de pantalla e informes de salida para facilitar la comprensión del usuario sobre el tema.

El contenido representa una muestra ficticia. Cualquier similitud con personas reales, viviendo o. muertos, o nombres de

empresas, activos o inactivos, es pura coincidencia y no se pretende de ninguna manera.

TABLA DE CONTENIDO

TABLA DE CONTENIDO............................................... .................................................. ............................................. 2

REVISION HISTORIA ................................................. .................................................. .................................................. .... 3

INTRODUCCIÓN AL DOCUMENTO ELECTRÓNICO DE SUJETOS NO OBLIGADOS A FACTURAR POR ISV A COLOMBIA ........... 4

ITENDIDO AUDIENCE ................................................. .................................................. .................................................. . 4

APLICACIONES TECNOLOGÍA ................................................. .................................................. ......................................... 5

INTEGRAR CON SOLUCIÓN DE TERCEROS (ISV) ........................................... .................................................. ... 6

SFINAL PAGROCESS ................................................. .................................................. .................................................. ......... 7

RETURN PAGROCESS ................................................. .................................................. .................................................. ... 11
CANÓNICO XML STRUCTURA ................................................. .................................................. ..................................... 15

USUARIO Y ROLES DE INTEGRACIÓN ISV ............................................. .................................................. .....................dieciséis

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
2
REVISIÓN HISTÓRICA

Este documento seguirá evolucionando a medida que cambien las secciones existentes y se agregue nueva información. Todas las actualizaciones son

registrado a continuación:

Datos Descripción de la versión Entrega incluida en el conjunto

de parches independiente

27-abr-2021 1 Creación de documentos 32539395 21C

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
3
INTRODUCCIÓN AL DOCUMENTO ELECTRÓNICO DE SUJETOS NO OBLIGADOS A FACTURAR
POR ISV A COLOMBIA

La Solución Local en la Nube de Latinoamérica (LACLS) para Colombia es un conjunto de componentes que complementa las funcionalidades centrales

proporcionando nuevas características que se utilizan para cumplir con los requisitos legales solicitados por las agencias gubernamentales.

Para Colombia, la agencia gubernamental responsable de establecer los requisitos legales se denomina DIAN (Dirección de
Impuestos y Aduanas Nacionales).

Lanzamiento de LACLS "Documento electrónico de sujetos no obligados a facturar”Solución para Colombia que proporciona extractores

de BI Publisher para generar archivos XML canónicos que contienen información sobre Facturas Oracle Payables (AP) elegibles para generar

Documento Electrónico de Sujetos No Obligados a Facturar (EFD). Los proveedores de software (ISV) pueden consumir el archivo XML para

crear archivos de documentos electrónicos que se enviarán a la agencia gubernamental (DIAN).

En este manual encontrará:

  Cómo llamar a los servicios web para ejecutar el extractor de BI Publisher;

  Cómo llamar a los servicios web para actualizar Oracle ERP Cloud;

  La estructura canónica de XML.

DESCRIPCIÓN GENERAL DEL FLUJO DE MACRO

PÚBLICO OBJETIVO

Bienvenido a Oracle BI Publisher de la solución local en la nube para América Latina para Colombia. Esta guía está
destinada a los consultores y analistas de productos de ISV.

Esta guía asume que tiene un conocimiento práctico de lo siguiente:

LACLS Colombia - Compra de Factura Electrónica para ISV - Guía Técnica de Implementación
4
 • Los principios y prácticas de su área de negocio;

• Uso y terminología de aplicaciones de escritorio de computadora;

  Arquitectura BIP;

  Conceptos de servicios web.

TECNOLOGÍA DE APLICACIONES

CONSUMO DE SERVICIOS WEB

El ISV debe estar familiarizado con las herramientas para consumir los servicios de API de SOAP y REST de Oracle ERP Cloud.

ARCHIVOS XML

El ISV debe tener una estructura XML familiar.

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
5
INTEGRARSE CON UNA SOLUCIÓN DE TERCEROS (ISV)

La solución Compra de Factura Electrónica para ISV a Colombia está compuesta por:

  "Documento electrónico de sujetos no obligados a facturar ” BI Publisher extractor

  WS SOAP API PublicReportService

  WS SOAP API ERPObjectDFFUpdateService

El ISV debe verificar con los implementadores funcionales de Oracle ERP Cloud si el extractor de BI Publisher está instalado y el
acceso necesario para ejecutar los extractores de BI Publisher y las API de WS.

El ISV es responsable de:

  Solicitar las Facturas que deban emitirse electrónicamente;

  Descomponer el archivo en facturas individuales;

  Transformar, validar y formatear según especificaciones DIAN;

  Incluya firma digital, cuando sea necesario;

  Control sobre qué Factura ya ha sido procesada y comunicada con DIAN; Obtenga la

  respuesta de la DIAN;

  Devuelva la información a Oracle ERP Cloud.

  Los nuevos requisitos legales establecidos por DIAN que involucran cambios en la estructura XML canónica deben ser informados
al equipo de Desarrollo LACLS de Oracle con anticipación.

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
6
ENVIAR PROCESO

La solución se basa en Facturas creadas bajo Oracle Payables (AP) en el ERP Cloud para Proveedores de Régimen
Simplificado.
La solución está compuesta por BI Publishers que exponen la información de AP en un XML canónico y dos Web Services
(WS): uno para ejecutar los extractores de BI y otro para devolver la información a AP.

Para recuperar las facturas de cuentas por pagar elegibles, ejecute los siguientes pasos:

1. Ejecute el "Sujetos de documentos electrónicos no obligados a facturar ” Extractor de BI Publisher para recuperar las facturas
aptas para generar un documento fiscal electrónico. Se crea un archivo XML de salida que contiene información sobre todas las
facturas recuperadas.

Instrucción:

Llame a la API de SOAP “<URL de Oracle ERP Cloud> / xmlpserver / services / PublicReportService? Wsdl"

Atributo Valor

Operación sacar un reporte

atributoFormat TXT
reportAbsolutPath / Personalizado / Solución local / CO / Numeración de documentos equivalentes / Proceso / Documento electrónico
Sujetos no obligados a Bill.xdo
Nombre de los parámetros de entrada Valor de los parámetros de entrada Defecto Requerido
P_LEGAL_ENTITY_ID Ponga el identificador de la entidad jurídica sí
P_BUSINESS_UNIT Ponga la unidad de negocio No
P_INVOICE_DATE_FROM Ponga la fecha de inicio de transacción para ejecutar la extracción sí
para transacciones específicas.
P_INVOICE_DATE_TO Ponga la fecha de finalización de la transacción para ejecutar la sí
extracción para transacciones específicas.

P_VENDOR_ID Indica el proveedor No

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
7
P_ROWNUM_LIMIT Indica el límite máximo para recuperar los encabezados 100 No
de las transacciones. Se requiere para evitar generar una
carga útil demasiado grande, lo que puede afectar el
proceso.
ID de usuario <Usuario de integración de Oracle ERP ISV>
Contraseña <Contraseña de usuario de integración de Oracle ERP ISV>

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
8
 Ejemplo:

Respuesta:

La "reportBytes”Muestra, en formato base64, la carga útil relacionada con todas las facturas recuperadas para ser procesadas.
Esta etiqueta debe decodificarse en formato XML.

2. Para cada Factura de Cuentas por Pagar recuperada contenida en el archivo XML de carga útil, el estado del “Documento
electrónico de sujetos no obligados a facturar” debe actualizarse a “ENVIADO”Que indica que la transacción ya ha sido
capturada por el ISV.

Instrucción:

Llame a la API de SOAP “<URL de Oracle ERP Cloud> / fscmService / ErpObjectDFFUpdateService? Wsdl”Individualmente para
cada factura devuelta. Informar los atributos a continuación:

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
9
 Atributo Valor

Operación updateDffEntityDetails
Modo de operación ÚNICO
Nombre de la entidad Factura de cuentas a pagar

ContextValue Valor de la etiqueta <Invoice> / <Header> / <Integration> / <AttributeCategory>.

UserKeyA Valor de la etiqueta <Invoice> / <Header> / <InvoiceNumber>
UserKeyB # NULO
UserKeyC # NULO
UserKeyD Valor de la etiqueta <Invoice> / <Header> / <InvoiceId>
UserKeyE # NULO
UserKeyF # NULO
UserKeyG # NULO
UserKeyH # NULO
{"<dff EFD Nombre del atributo de estado>”:“ <Estado EFD>"}

Dónde:
DFFAttributes
<dff EFD Nombre del atributo de estado> = valor de la etiqueta <Factura> / <Encabezado> / <Integración> / <EfdStatus>

<Estado EFD> = cadena "ENVIADO"

Ejemplo:

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
10
 Ejemplo de respuesta:
Tenga en cuenta que el resultado devuelto debe ser 1, lo que indica que la actualización se ejecutó correctamente.

PROCESO DE DEVOLUCIÓN

Una vez que DIAN ha respondido, el ISV debe devolver esta información a Oracle ERP Cloud. Toda la información sobre el documento fiscal
electrónico emitido se registra en Oracle ERP Cloud en Descriptive Flexfields (DFFs) de acuerdo con la definición de configuración de LACLS en
el encabezado de la Factura de Cuentas por Pagar.

DFF es un campo de datos flexible que el cliente de Oracle puede configurar de acuerdo con sus necesidades comerciales sin necesidad de
programación. Tenga en cuenta que el DFF se utiliza para ingresar información adicional para la cual su producto de Aplicaciones Oracle aún
no ha proporcionado un campo.

Cada empresa puede crear esos DFF en diferentes columnas de atributos, denominadas ATRIBUTO <número>, según su
disponibilidad. Por lo tanto, cuando se realiza el proceso de devolución, es necesario comprender el mapeo entre los nombres de los
atributos de las columnas y el conjunto de información requerido.

El flujo de retorno deberá actualizar algunos DFF, ya que contienen la siguiente información:

  Estado EFD:

  APROBADO - Indica que el documento fiscal electrónico fue procesado y aprobado por la DIAN;

  RECHAZADO - Indica que el documento fiscal electrónico fue procesado y rechazado por la DIAN.

  ENVIADO - Indica que el documento fiscal electrónico fue capturado por el ISV.

  Nulo - Indica documentos fiscales electrónicos que es necesario enviar a ISV (nuevos o los previos fijos
en estado RECHAZADO).

  Número EFD - Número de Llave asignada por DIAN;

  Fecha EFD - Fecha de generación de la clave.

  EFDMessage - Mensajes relevantes (opcional).

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
11
Para hacer la devolución de esa información, el ISV debe llamar a una API para actualizar los campos Documento Electrónico de
Sujetos No Obligados a Facturar de la Factura AP. Esta API requiere como parámetros de entrada los nombres de los campos y el
contenido de cada campo.

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
12
DEVOLVER LA INFORMACIÓN EFD A ORACLE ERP CLOUD

Una vez que se conoce el mapeo de atributos (grupo de integración), la información del comprobante electrónico de la transacción
debe actualizarse de acuerdo con la información devuelta por la DIAN.

Instrucción:

Llame a la API de SOAP "<URL de Oracle ERP Cloud> / fscmService / ErpObjectDFFUpdateService? Wsdl"

Atributo Valor

Operación updateDffEntityDetails
Modo de operación ÚNICO
Nombre de la entidad Factura de cuentas a pagar

ContextValue
Valor de la etiqueta <Invoice> / <Header> / <Integration> / <AttributeCategory>.

UserKeyA Valor de la etiqueta <Invoice> / <Header> / <InvoiceNumber>

UserKeyB # NULO
UserKeyC # NULO
UserKeyD Esta información está disponible en la etiqueta <Invoice> / <Header> / <InvoiceId>
UserKeyE # NULO
UserKeyF # NULO
UserKeyG # NULO
UserKeyH # NULO
DFFAttributes {"<dff EFD Nombre del atributo de estado>”:“ <Estado EFD>”,” <dff Nombre de atributo de número EFD>”:“ <
Número de clave>”,“ <dff EFD Fecha Nombre del atributo>”:“ <Fecha clave>”,“ <dff Nombre de atributo de
mensaje EFD>”:“ <Mensaje>"}

Dónde:

<dff EFD Nombre del atributo de estado> = valor de la etiqueta

<Factura> / <Encabezado> / <Integración> / <EfdStatus>

<Estado EFD> = cuerda "APROBADO" (si se aprobó el EFD) o "RECHAZADO" (para los EFD rechazados)

<dff Nombre de atributo de número EFD> = valor de la etiqueta

<Invoice> / <Header> / <Integration> / <EfdKeyNumber>

<Número de clave> = Número de clave recuperado por DIAN

<dff EFD Fecha Nombre del atributo> = valor de la etiqueta

<Invoice> / <Header> / <Integration> / <EfdKeyDate>

<Fecha clave> = Fecha de la clave recuperada por DIAN

<dff Nombre de atributo de mensaje EFD> = valor de la

etiqueta <Invoice> / <Header> / <Integration> / <EfdMessage>

<dff EFD Mensaje> = mensaje relevante (opcional).

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
13
Ejemplo:

Importante: El resultado de la respuesta debe ser APROBADO, lo que indica que la actualización se ejecutó correctamente.

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
14
ESTRUCTURA XML CANÓNICA

Comprender la estructura y el mapeo de campos de los archivos XML generados por el Enviar y Regreso procesos, verifique el
archivo de mapeo "Mapeo canónico XML de Colombia para sujetos de documentos electrónicos no obligados a Bill.xlsx”.

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
15
USUARIO Y ROLES DE INTEGRACIÓN ISV

Es obligatorio tener un usuario en Oracle ERP Cloud para permitir que ISV ejecute:

  WS responsable de ejecutar BI Publisher; WS

  responsable de actualizar los DFF.

Recomendamos crear un usuario específico para ser utilizado como "Usuario de Integración ERP ISV" en lugar de utilizar un usuario normal de persona

física.

Siguiendo la recomendación para Roles:

Roles de trabajo

  Especialista en integración financiera

  Especialista en integración

  Rol de consumidor de BI

  Privilegio de extracción de API de descanso

Después de asignar los roles al usuario de integración de ISV, ejecute los siguientes procesos:

  Importar datos de seguridad de la aplicación de rol y usuario

  Recuperar los últimos cambios LDAP

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
dieciséis
Copyright © 2021, Oracle y / o sus afiliados. Reservados todos los derechos.

Este documento se proporciona únicamente con fines informativos y su contenido está sujeto a cambios sin previo aviso. No se garantiza que este documento esté libre de errores ni esté sujeto a ninguna otra garantía o

condición, ya sea expresada verbalmente o implícita en la ley, incluidas las garantías implícitas y las condiciones de comerciabilidad o idoneidad para un propósito particular. Renunciamos específicamente a cualquier

responsabilidad con respecto a este documento, y este documento no forma ninguna obligación contractual, ya sea directa o indirectamente. Este documento no puede reproducirse ni transmitirse de ninguna forma ni por

ningún medio, electrónico o mecánico, para ningún propósito, sin nuestro permiso previo por escrito.

Oracle y Java son marcas comerciales registradas de Oracle y / o sus afiliadas. Otros nombres pueden ser marcas comerciales de sus respectivos propietarios.

Intel e Intel Xeon son marcas comerciales o marcas comerciales registradas de Intel Corporation. Todas las marcas comerciales de SPARC se utilizan bajo licencia y son marcas comerciales o marcas comerciales registradas

de SPARC International, Inc. AMD, Opteron, el logotipo de AMD y el logotipo de AMD Opteron son marcas comerciales o marcas comerciales registradas de Advanced Micro Devices. UNIX es una marca registrada de The

Open Group.

LACLS Colombia - Documento Electrónico de Sujetos No Obligados a Facturar - Guía Técnica de Implementación
17