En este articulo se describen todos los pasos necesarios para implementar correctamente el escenario de B1IC que permite el envío de información desde a SAP Business One a la AEAT como parte de la solución de SAP para el proceso de Suministro Inmediato de Información en SAP Business One.
Detallar paso a paso el proceso de instalación y configuración del B1IC y el escenario de SAP para el Suministro Inmediato de Información, sap.ESP.sii.
Dentro del material de instalación de SAP Business One, en la carpeta Packages\B1 Integration Component\Tecnology se encuentra el programa de instalación de B1IC (setup.exe)
Este asistente instala los siguientes componentes:
Estos componentes se pueden instalar en el mismo servidor donde están los componentes de servidor de SAP Business One o se pueden instalar en otro servidor diferente, según sean las condiciones y necesidades del cliente.
También es posible instalar el Integration Framework Server en un servidor y los componentes adicionales (Event Sender y DIProxy) en otro.
La instalación de estos componentes no tiene mayor dificultad, pero hay que tener en cuenta lo siguiente:
En el servidor donde se instale el B1IC debe estar instalada la DIAPI. Si no está instalada, se recomienda instalar la versión de 64 bits.
La contraseña que se pide en esta página del asistente es la del usuario administrador de B1IC, el B1iadmin.
No activar ningún escenario que no sea imprescindible.
El B1IC, para su funcionamiento necesita una base de datos y hay que informar todos los campos para que el instalador pueda acceder a el y crear la base de datos.
Al final de la instalación, los siguientes servicios deben haber quedado instalados y en ejecución:
Es importante después de la instalación revisar que en el SLD de B1IC se hayan creado automáticamente las configuraciones para cada empresa SAP Business One y que estas se conecten de forma correcta.
Para esto, desde el servidor donde está instalado el B1IC hay que abrir un navegador y acceder a su aplicación de administración: http://127.0.0.1:8080/B1iXcellerator/exec/dummy/com.sap.b1ip.system.cc/bfd/AdminConsole.bfd?!defdoc=...
Informar el campo User con B1iadmin y Password con la contraseña que se ha definido en el momento de instalación del B1IC.
Al pulsar el botón Logon, ir a la página SLD:
En la parte izquierda deben estar definidas todas las empresas que hay en SAP Business One. Si no es así, dirigirse a la nota SAP 1618978
Seleccionar una de las empresas y pulsar los botones Test Connection referentes a B1DI y JDBC para hacer la comprobación de conexión.
Si la conexión es correcta, debe aparecer un mensaje:
Repetir el proceso para todas las empresas.
Los motivos habituales por los que falla esta comprobación son:
El escenario se distribuye como un fichero ZIP (ver la sección material necesario en este articulo)
En la aplicación de administración de B1IC ir a SCENARIOS -> Import
Seleccionar el fichero ZIP con el escenario y marcar Import Individual SysType Properties
Apretar el botón Submit para iniciar el proceso de importación y en la siguiente pantalla, apretar el botón Import:
mostrándose un mensaje de Import completed para indicar que el escenario se ha importado correctamente.
El escenario estará desactivado hasta que no lo configuremos y activemos.
La actualización del escenario requiere que este esté desactivado. Se puede desactivar antes de empezar la actualización o lo hará el propio B1IC antes de realizar el proceso de actualización.
Para actualizar el escenario ir a SCENARIOS -> Import:
(1) Especificar el fichero ZIP con la versión actualizada del escenario
(2) Activar Import Individual SysType Properties
(3) Pulsar el botón Submit
B1IC analizará el nuevo escenario y si todo va bien nos mostrará una nueva página:
donde nos mostrará la versión actual y la que contiene el fichero ZIP.
(1) Pulsar el botón Import para iniciar la actualización
Si el escenario está activado, B1IC nos mostrará un mensaje de advertencia:
para continuar, pulsamos OK y el B1IC desactivará automáticamente el escenario y empezará el proceso de actualización.
Si todo va bien, saldrá una ventana con todos los pasos del escenario actualizados, que deberemos cerrar para que salga el mensaje de importación con éxito:
En este punto el escenario estará desactivado y deberemos reactivarlo.
Para esto, deberemos ir a SCENARIOS -> Control:
y pulsar sobre el cuadro de control que deberá estar desmarcado para el escenario sap.ESP.sii y nos aparecerá la ventana:
y pulsar el botón Activate para que se inicie el proceso de preparación de la activación, que cuando termine, nos mostrará el siguiente mensaje:
Pulsamos OK y en unos instantes, debe aparecer el mensaje de confirmación de que la activación ha tenido éxito:
Al apretar OK, nos aparece la ventana de activación con el status ok en verde, indicando que el escenario está totalmente operativo:
Para importar un certificado directamente dentro del escenario sap.ESP.sii hay que ir al Centro del Control, en TOOLS -> Control Center
Se abre otra ventana diferente con el centro de control.
En el centro de control, seleccionar MAINTENANCE -> BizStore Upload
El campo Payload Type Settings debe contener bpm.pltype=cert
En el campo File Name hay que seleccionar el fichero PFX que queremos importar
En BizStore URI, pulsar el botón (...) y utilizar el asistente de navegación para seleccionar el URI donde vamos a subir el fichero:
El BizStore Dataset debe ser com.sap.b1i.vplatform.scenarios.design
el BizStore group debe ser vPac.sap.ESP.sii
El BizStore Unique Alias debe ser unified
y el BizStore Document debe ser un nombre que haga que el URI sea único.
En este ejemplo he seleccionado intrxpfx, lo que genera el URI /com.sap.b1i.vplatform.scenarios.design/vPac.sap.ESP.sii/intarexpfx(unified)
Este URI hay que anotarlo en algún sitio, pues lo vamos a necesitar cuando configuremos el certificado en cada empresa del SLD.
Si el cliente tiene varias empresas y cada una tiene su certificado (lo normal), debemos repetir estos pasos para cada certificado, solo variando el nombre que damos en el último paso. Tendremos un URI para cada certificado.
Ir a las propiedades de la empresa dentro del SLD:
Modificar los valores de las propiedades PKuri, con el URI obtenido al subir el certificado en la BizStore, y PKpassword, con la contraseña del fichero PFX, y pulsar el botón de guardar los cambios:
NOTA: La contraseña se puede especificar tanto en su formato encriptado como sin encriptar (más información en este enlace)
Repetir este proceso para todas las empresas que participen dentro del Suministro Inmediato de Información
Ir a SCENARIOS -> Setup y seleccionar el escenario sap.ESP.sii
Los pasos para configurar y activar correctamente el escenario son:
Pulsar el botón Steps:
Pulsar el botón All Activate y pulsar el botón de guardar los cambios:
Pulsar el botón Sender:
Seleccionar Define Sender List:
Seleccionar todas aquellas empresas que participen dentro del Suministro Inmediato de Información y pulsar el botón de guardar los cambios:
Pulsar el botón Data Mgt. para modificar las propiedades globales del escenario:
Seleccionar Global Properties:
Definir las URL de los servicios web a utilizar y pulsar el botón de guardar los cambios:
Las URLs de la AEAT son las siguientes:
Facturas emitidas: https://www7.aeat.es/wlpl/SSII-FACT/ws/fe/SiiFactFEV1SOAP
Facturas recibidas: https://www7.aeat.es/wlpl/SSII-FACT/ws/fr/SiiFactFRV1SOAP
Cobros emitidos: https://www7.aeat.es/wlpl/SSII-FACT/ws/fe/SiiFactCOBV1SOAP
Pagos recibidos: https://www7.aeat.es/wlpl/SSII-FACT/ws/fr/SiiFactPAGV1SOAP
Bienes de inversión: https://www7.aeat.es/wlpl/SSII-FACT/ws/bi/SiiFactBIV1SOAP
Operaciones intracomunitarias: https://www7.aeat.es/wlpl/SSII-FACT/ws/oi/SiiFactOIV1SOAP
Otras operaciones de trascendencia tributaria: https://www7.aeat.es/wlpl/SSII-FACT/ws/pm/SiiFactCMV1SOAP
Facturas emitidas: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fe/SiiFactFEV1SOAP
Facturas recibidas: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fr/SiiFactFRV1SOAP
Cobros emitidos: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fe/SiiFactCOBV1SOAP
Pagos recibidos: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fr/SiiFactPAGV1SOAP
Bienes de inversión: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/bi/SiiFactBIV1SOAP
Operaciones intracomunitarias: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/oi/SiiFactOIV1SOAP
Otras operaciones de trascendencia tributaria: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/pm/SiiFactCMV1SOAP
IMPORTANTE: En este escenario solo están implementados los servicios web de facturas emitidas y recibidas, pagos recibidos y otras operaciones de trascendencia tributaria.
Finalmente, debemos activar el escenario para que se empiecen a procesar todos los eventos producidos en SAP Business One relevantes para el Suministro Inmediato de Información:
Pulsar el botón Activate:
Pulsar el botón Activate:
Si todo va bien debe salir un mensaje indicando que la preparación de la activación se ha completado correctamente, pulsa OK para activar el escenario:
Si la activación se ha completado sin errores, saldrá un mensaje de confirmación:
y podremos ver que el escenario se ha activado correctamente:
IMPORTANTE: Hay que tener en cuenta que mientras el escenario está desactivado se continúan procesando los eventos que vienen de SAP Business One pero al no pasar por el escenario, no se envíen ni reciben datos de la AEAT. Lo más importante de esto es que si mientras el escenario está desactivado un usuario de SAP Business One enviar documentos con la opción de Suministro de Información inmediato del menú del módulo de finanzas, estos documentos quedarán con estado Nuevo en el monitor y nunca avanzaran.
Para desactivar un escenario, ir a SCENARIOS -> Control:
y pulsar sobre el cuadro de control del escenario sap.ESP.sii.
Este articulo pertenece a una serie de artículos sobre el Suministro Inmediato de Información para SAP Business One. Puede consultar el primer articulo de la serie en este enlace.
Objetivo
Detallar paso a paso el proceso de instalación y configuración del B1IC y el escenario de SAP para el Suministro Inmediato de Información, sap.ESP.sii.
Material Necesario
- Asistente de instalación del B1IC, que se encuentra dentro del material de instalación de SAP Business One
- Escenario sap.ESP.sii (versión actual 1.0.2) | Nota SAP 2494985 | Descargar
Visión General
- Instalación del B1IC
- Comprobación de conectividad de B1IC con SAP Business One
- Instalación del escenario sap.ESP.sii
- Actualización del escenario sap.ESP.sii
- Importación de los certificados
- Configuración de los certificados en cada empresa
- Configuración del escenario sap.ESP.sii
- Activación del escenario sap.ESP.sii
- Desactivación del escenario sap.ESP.sii
Instalación de B1IC
Dentro del material de instalación de SAP Business One, en la carpeta Packages\B1 Integration Component\Tecnology se encuentra el programa de instalación de B1IC (setup.exe)
Este asistente instala los siguientes componentes:
Estos componentes se pueden instalar en el mismo servidor donde están los componentes de servidor de SAP Business One o se pueden instalar en otro servidor diferente, según sean las condiciones y necesidades del cliente.
También es posible instalar el Integration Framework Server en un servidor y los componentes adicionales (Event Sender y DIProxy) en otro.
La instalación de estos componentes no tiene mayor dificultad, pero hay que tener en cuenta lo siguiente:
En el servidor donde se instale el B1IC debe estar instalada la DIAPI. Si no está instalada, se recomienda instalar la versión de 64 bits.
La contraseña que se pide en esta página del asistente es la del usuario administrador de B1IC, el B1iadmin.
No activar ningún escenario que no sea imprescindible.
El B1IC, para su funcionamiento necesita una base de datos y hay que informar todos los campos para que el instalador pueda acceder a el y crear la base de datos.
Al final de la instalación, los siguientes servicios deben haber quedado instalados y en ejecución:
Comprobación de conectividad de B1IC con SAP Business One
Es importante después de la instalación revisar que en el SLD de B1IC se hayan creado automáticamente las configuraciones para cada empresa SAP Business One y que estas se conecten de forma correcta.
Para esto, desde el servidor donde está instalado el B1IC hay que abrir un navegador y acceder a su aplicación de administración: http://127.0.0.1:8080/B1iXcellerator/exec/dummy/com.sap.b1ip.system.cc/bfd/AdminConsole.bfd?!defdoc=...
Informar el campo User con B1iadmin y Password con la contraseña que se ha definido en el momento de instalación del B1IC.
Al pulsar el botón Logon, ir a la página SLD:
En la parte izquierda deben estar definidas todas las empresas que hay en SAP Business One. Si no es así, dirigirse a la nota SAP 1618978
Seleccionar una de las empresas y pulsar los botones Test Connection referentes a B1DI y JDBC para hacer la comprobación de conexión.
Si la conexión es correcta, debe aparecer un mensaje:
Repetir el proceso para todas las empresas.
Los motivos habituales por los que falla esta comprobación son:
- Error en la contraseña del usuario B1i dentro de SAP Business One
- DIAPI no está instalada
- La configuración de la DIAPI no es correcta (local-machine.xml)
Instalación del escenario sap.ESP.sii para B1IC
El escenario se distribuye como un fichero ZIP (ver la sección material necesario en este articulo)
En la aplicación de administración de B1IC ir a SCENARIOS -> Import
Seleccionar el fichero ZIP con el escenario y marcar Import Individual SysType Properties
Apretar el botón Submit para iniciar el proceso de importación y en la siguiente pantalla, apretar el botón Import:
mostrándose un mensaje de Import completed para indicar que el escenario se ha importado correctamente.
El escenario estará desactivado hasta que no lo configuremos y activemos.
Actualización del escenario sap.ESP.sii
La actualización del escenario requiere que este esté desactivado. Se puede desactivar antes de empezar la actualización o lo hará el propio B1IC antes de realizar el proceso de actualización.
Para actualizar el escenario ir a SCENARIOS -> Import:
(1) Especificar el fichero ZIP con la versión actualizada del escenario
(2) Activar Import Individual SysType Properties
(3) Pulsar el botón Submit
B1IC analizará el nuevo escenario y si todo va bien nos mostrará una nueva página:
donde nos mostrará la versión actual y la que contiene el fichero ZIP.
(1) Pulsar el botón Import para iniciar la actualización
Si el escenario está activado, B1IC nos mostrará un mensaje de advertencia:
para continuar, pulsamos OK y el B1IC desactivará automáticamente el escenario y empezará el proceso de actualización.
Si todo va bien, saldrá una ventana con todos los pasos del escenario actualizados, que deberemos cerrar para que salga el mensaje de importación con éxito:
En este punto el escenario estará desactivado y deberemos reactivarlo.
Para esto, deberemos ir a SCENARIOS -> Control:
y pulsar sobre el cuadro de control que deberá estar desmarcado para el escenario sap.ESP.sii y nos aparecerá la ventana:
y pulsar el botón Activate para que se inicie el proceso de preparación de la activación, que cuando termine, nos mostrará el siguiente mensaje:
Pulsamos OK y en unos instantes, debe aparecer el mensaje de confirmación de que la activación ha tenido éxito:
Al apretar OK, nos aparece la ventana de activación con el status ok en verde, indicando que el escenario está totalmente operativo:
Importación de los certificados
Para importar un certificado directamente dentro del escenario sap.ESP.sii hay que ir al Centro del Control, en TOOLS -> Control Center
Se abre otra ventana diferente con el centro de control.
En el centro de control, seleccionar MAINTENANCE -> BizStore Upload
El campo Payload Type Settings debe contener bpm.pltype=cert
En el campo File Name hay que seleccionar el fichero PFX que queremos importar
En BizStore URI, pulsar el botón (...) y utilizar el asistente de navegación para seleccionar el URI donde vamos a subir el fichero:
El BizStore Dataset debe ser com.sap.b1i.vplatform.scenarios.design
el BizStore group debe ser vPac.sap.ESP.sii
El BizStore Unique Alias debe ser unified
y el BizStore Document debe ser un nombre que haga que el URI sea único.
En este ejemplo he seleccionado intrxpfx, lo que genera el URI /com.sap.b1i.vplatform.scenarios.design/vPac.sap.ESP.sii/intarexpfx(unified)
Este URI hay que anotarlo en algún sitio, pues lo vamos a necesitar cuando configuremos el certificado en cada empresa del SLD.
Si el cliente tiene varias empresas y cada una tiene su certificado (lo normal), debemos repetir estos pasos para cada certificado, solo variando el nombre que damos en el último paso. Tendremos un URI para cada certificado.
Configuración del certificado en cada empresa
Ir a las propiedades de la empresa dentro del SLD:
Modificar los valores de las propiedades PKuri, con el URI obtenido al subir el certificado en la BizStore, y PKpassword, con la contraseña del fichero PFX, y pulsar el botón de guardar los cambios:
NOTA: La contraseña se puede especificar tanto en su formato encriptado como sin encriptar (más información en este enlace)
Repetir este proceso para todas las empresas que participen dentro del Suministro Inmediato de Información
Configuración del escenario sap.ESP.sii
Ir a SCENARIOS -> Setup y seleccionar el escenario sap.ESP.sii
Los pasos para configurar y activar correctamente el escenario son:
- Activación de todos los pasos
- Definición de las empresas que deben procesarse
- Definición de los parámetros globales (URLs de la AEAT)
- Activación del escenario
Pulsar el botón Steps:
Pulsar el botón All Activate y pulsar el botón de guardar los cambios:
Pulsar el botón Sender:
Seleccionar Define Sender List:
Seleccionar todas aquellas empresas que participen dentro del Suministro Inmediato de Información y pulsar el botón de guardar los cambios:
Pulsar el botón Data Mgt. para modificar las propiedades globales del escenario:
Seleccionar Global Properties:
Definir las URL de los servicios web a utilizar y pulsar el botón de guardar los cambios:
Las URLs de la AEAT son las siguientes:
Entorno de pruebas
Facturas emitidas: https://www7.aeat.es/wlpl/SSII-FACT/ws/fe/SiiFactFEV1SOAP
Facturas recibidas: https://www7.aeat.es/wlpl/SSII-FACT/ws/fr/SiiFactFRV1SOAP
Cobros emitidos: https://www7.aeat.es/wlpl/SSII-FACT/ws/fe/SiiFactCOBV1SOAP
Pagos recibidos: https://www7.aeat.es/wlpl/SSII-FACT/ws/fr/SiiFactPAGV1SOAP
Bienes de inversión: https://www7.aeat.es/wlpl/SSII-FACT/ws/bi/SiiFactBIV1SOAP
Operaciones intracomunitarias: https://www7.aeat.es/wlpl/SSII-FACT/ws/oi/SiiFactOIV1SOAP
Otras operaciones de trascendencia tributaria: https://www7.aeat.es/wlpl/SSII-FACT/ws/pm/SiiFactCMV1SOAP
Entorno de producción (a partir del 1 de Julio de 2017)
Facturas emitidas: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fe/SiiFactFEV1SOAP
Facturas recibidas: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fr/SiiFactFRV1SOAP
Cobros emitidos: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fe/SiiFactCOBV1SOAP
Pagos recibidos: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/fr/SiiFactPAGV1SOAP
Bienes de inversión: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/bi/SiiFactBIV1SOAP
Operaciones intracomunitarias: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/oi/SiiFactOIV1SOAP
Otras operaciones de trascendencia tributaria: https://www1.agenciatributaria.gob.es/wlpl/SSII-FACT/ws/pm/SiiFactCMV1SOAP
IMPORTANTE: En este escenario solo están implementados los servicios web de facturas emitidas y recibidas, pagos recibidos y otras operaciones de trascendencia tributaria.
Activación del escenario sap.ESP.sii
Finalmente, debemos activar el escenario para que se empiecen a procesar todos los eventos producidos en SAP Business One relevantes para el Suministro Inmediato de Información:
Pulsar el botón Activate:
Pulsar el botón Activate:
Si todo va bien debe salir un mensaje indicando que la preparación de la activación se ha completado correctamente, pulsa OK para activar el escenario:
Si la activación se ha completado sin errores, saldrá un mensaje de confirmación:
y podremos ver que el escenario se ha activado correctamente:
Desactivación del escenario
IMPORTANTE: Hay que tener en cuenta que mientras el escenario está desactivado se continúan procesando los eventos que vienen de SAP Business One pero al no pasar por el escenario, no se envíen ni reciben datos de la AEAT. Lo más importante de esto es que si mientras el escenario está desactivado un usuario de SAP Business One enviar documentos con la opción de Suministro de Información inmediato del menú del módulo de finanzas, estos documentos quedarán con estado Nuevo en el monitor y nunca avanzaran.
Para desactivar un escenario, ir a SCENARIOS -> Control:
y pulsar sobre el cuadro de control del escenario sap.ESP.sii.
- SAP Managed Tags:
8 Comments
