La interfaz de cumplimiento del Vat puede utilizarse para crear automáticamente la estructura organizativa necesaria en el RetailForce portal.
Para ello, el sistema de origen debe incluir en el payload del documento la información necesaria para crear las entidades pertinentes.
Requisitos previos
Para que la creación automática de la estructura funcione, deben cumplirse los siguientes requisitos previos.
- Se ha creado la organización y
- se ha creado la configuración del servidor,
- se ha creado la configuración,
- se han asignado las licencias,
- configuración asignada a la organización.
Organización
La organización debe existir previamente en el RetailForce Cloud Portal, ya que la payload procedente del sistema de origen debe hacer referencia a un «OrganisationId» existente al crear una nueva estructura.
Nota: no es posible crear empresas mediante este mecanismo.
Configuración del servidor
Debe crearse una configuración de servidor que utilice el «tipo de conexión» correcto.
Configuración
Debe crearse una configuración que:
- esté vinculada a la configuración del servidor,
- tenga asignadas licencias,
- se encuentre asignada a la organización correspondiente.
Payload del sistema de origen
A través de la payload del sistema de origen se puede crear tanto una nueva tienda como un nuevo terminal. Para ello, la payload debe contener la siguiente información:
- "OrganisationId",
- información de la tienda,
- información del terminal.
OrganisationId
El «OrganisationId» debe hacer referencia a la organización creada en el RetailForce Cloud Portal. También se denomina «LicenseConsumerId» y puede consultarse en el portal, en las propiedades de la organización.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Información de la tienda
Posibles propiedades para crear una nueva tienda.
"Store": {
"StoreId": "00000000-0000-0000-0000-000000000000"
"OrganisationId": "00000000-0000-0000-0000-000000000000",
"CompanyId": null,
"StoreNumber": "003",
"Caption": "Teststore 003",
"FiscalRegion": null,
"Telephone": null,
"Fax": null,
"EMail": null,
"OpeningDate": null,
"ClosingDate": null,
"HiddenDate": null,
"UpdatedByPrincipalId": null,
"OpeningHoursMonday": null,
"OpeningHoursTuesday": null,
"OpeningHoursWednesday": null,
"OpeningHoursThursday": null,
"OpeningHoursFriday": null,
"OpeningHoursSaturday": null,
"OpeningHoursSunday": null,
"ClientConfigurationId": null,
"NewClientConfigurationId": null,
"NewClientConfigurationValidFrom": null,
"Street": "Av. Gustave Eiffel",
"StreetNumber": "-",
"PostalCode": "75007",
"City": "Paris",
"CountryCode": "FRA"
},Información de la columna «Tipo»:
- M ... obligatorio («mandatory»)
- M* ... obligatorio en determinados países o bajo ciertas condiciones
- R ... recomendado («recomendado»)
- O ... opcional
| Elemento | Tipo |
Descripción | |
| Tienda |
|
Información de la tienda | |
| StoreId | M |
Si es necesario crear una nueva tienda, utilice el valor «00000000-0000-0000-0000-000000000000» en la primera payload y en todas las siguientes. | |
OrganisationId |
M |
ID de la organización; no es necesario, ya que la propiedad «OrganisationId» fuera del objeto de tienda ya hace referencia a la organización correspondiente. Utilice siempre: «00000000-0000-0000-0000-000000000000» |
|
CompanyId |
O |
No es obligatorio; puede utilizarse si se ha creado una empresa bajo la organización. | |
StoreNumber |
M |
Número de la tienda o sucursal. | |
Caption |
M |
Denominación de la tienda o sucursal. | |
Región fiscal |
M* |
Solo es obligatorio en países en los que existen regiones fiscales (p. ej., España). | |
Teléfono |
O |
Datos de contacto del punto de venta: número de teléfono. | |
| Fax | O |
Datos de contacto de la tienda: Número de fax. | |
| Correo electrónico | O |
Datos de contacto de la tienda: dirección de correo electrónico. | |
Fecha de apertura |
M* |
Solo es obligatorio en los países en los que se debe especificar la fecha de apertura de la tienda (p. ej., Eslovenia). | |
| ClosingDate | O |
No debe especificarse, ya que representa la fecha de cierre definitivo de un local comercial (cuando la tienda cerró definitivamente). | |
| Datos ocultos | O |
No debe especificarse, ya que representa la fecha en la que la tienda se ocultó en el Portal debido a que todos los terminales asociados fueron dados de baja. | |
UpdatedByPrincipalId |
|
No debe especificarse. | |
HorarioDeAperturaLunes |
O |
Horario de apertura del lunes. | |
Horario de apertura: martes |
O |
Horario de apertura del martes. | |
Horario de apertura del miércoles |
O |
Horario de apertura del miércoles. | |
Horario de apertura del jueves |
O |
Horario de apertura del jueves. | |
Horario de apertura del viernes |
O |
Horario de apertura del viernes. | |
Horario de apertura del sábado |
O |
Horario de apertura del sábado. | |
Horario de apertura el domingo |
O |
Horario de apertura del domingo. | |
Id. de configuración del cliente |
O |
ID de la configuración; no es obligatorio. | |
NewClientConfigurationId |
O |
ID de una nueva configuración; no es obligatorio. | |
NewClientConfigurationValidFrom |
O |
Fecha a partir de la cual entra en vigor una nueva configuración. | |
Calle |
M |
Nombre de la calle en la que se encuentra la tienda o sucursal. | |
StreetNumber |
M |
Número de la calle de la tienda o sucursal. | |
PostalCode |
M |
Código postal de la tienda o sucursal. | |
Ciudad |
M |
Ciudad de la tienda o sucursal. | |
CountryCode |
M |
Código de país (ISO 3166-1 Alfa-3). | |
Parámetros de la tienda
Es posible configurar parámetros opcionales de la tienda en aquellos países en los que esté disponible, por ejemplo, Francia, Eslovenia, Croacia y otros.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Información en la columna «Tipo»:
- M ... obligatorio («mandatory»)
- M* ... obligatorio en determinados países o bajo ciertas condiciones
- R ... recomendado («recomendado»)
- O ... opcional
| Elementos | Tipo |
Descripción | |
| StoreParameters |
|
||
| ParameterName | O |
Denominación del parámetro. | |
| ParameterValue | O |
Valor del parámetro. | |
| ParámetroCifrado | O |
Indicador de si el parámetro está cifrado. | |
| ParameterOnlyServer | O |
Seleccione esta opción si el parámetro solo se utiliza en la configuración del servidor. | |
Información del terminal
"Terminal": {
"TerminalId": "00000000-0000-0000-0000-000000000000",
"StoreId": "00000000-0000-0000-0000-000000000000",
"TerminalNumber": "009",
"FiscalCountry": null,
"Caption": "Testterminal 003/009",
"PlatformType": null,
"IsTest": true,
"IsDisabledGetConfigurationLimit": null,
"ArchiveDate": null,
"ClientConfigurationId": null,
"NewClientConfigurationId": null,
"NewClientConfigurationValidFrom": null,
"GlobalShortId": null,
"PurchaseDate": null,
"TerminalType": null,
"UpdatedByPrincipalId": null,
"CashRegisterId": null,
"CashRegisterBrand": null,
"CashRegisterModelname": null,
"CashRegisterSerialNumber": null,
"CashRegisterSoftwareBrand": null,
"CashRegisterSoftwareVersion": null,
"CashRegisterSoftwareCompany": null,
"CommissioningDate": null
},Información de la columna «Tipo»:
- M ... obligatorio («mandatory»)
- M* ... obligatorio en determinados países o en determinadas condiciones
- R ... recomendado («recomendado»)
- O ... opcional
| Elementos | Tipo |
Descripción | |
| Terminal |
|
Información del terminal | |
terminalId |
M |
Si es necesario crear un nuevo terminal, utilice el identificador «00000000-0000-0000-0000-000000000000» en la primera carga útil y en todas las subsiguientes. | |
StoreId |
M |
Utilice siempre «00000000-0000-0000-0000-000000000000». | |
terminalNumber |
M |
Número de caja registradora dentro de la tienda. | |
fiscalCountry |
O |
No obligatorio. | |
Etiqueta |
R |
Denominación de la caja registradora. | |
Tipo de plataforma |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Solo es posible para terminales de prueba («IsTest»: true). | |
ArchiveDate |
O |
No se especifica; indica cuándo se retiró del servicio el terminal y se archivó. | |
ClientConfigurationId |
O |
ID de la configuración; no es obligatorio. | |
NewClientConfigurationId |
O |
ID de una nueva configuración; no es obligatorio. | |
NewClientConfigurationValidFrom |
O |
Fecha a partir de la cual entra en vigor una nueva configuración. | |
GlobalShortId |
|
ID global abreviado del terminal; no es configurable, lo asigna el sistema RF. | |
FechaDeCompra |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
Tipo de terminal |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
UpdatedByPrincipalId |
|
No debe especificarse. | |
cashRegisterId |
M* |
Solo es obligatorio en determinados países (p. ej., Alemania) | |
CashRegisterBrand |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
Nombre del modelo de caja registradora |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
Número de serie de la caja registradora |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
Marca del software de la caja registradora |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
Versión del software de caja registradora |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
Empresa del software de caja registradora |
M* |
Obligatorio únicamente en determinados países (p. ej., Alemania) | |
Fecha de puesta en servicio |
|
No debe introducirse. | |
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.