En este artículo se explica cómo consultar las distintas propiedades de los países y cómo localizarlas en la RetailForce Cloud. Al final del artículo se incluye una explicación de los diferentes elementos de las fiscalCountryProperties.
Con el fin de ilustrar las implementaciones necesarias para su proyecto, se han creado las propiedades de país (fiscalCountryProperties). Estas indican qué partes de la interfaz global deben implementarse como mínimo para cada país.
Las propiedades de país están disponibles a partir de la versión V1.2.12 (excepto para el client, a partir de la V1.2.13).
Consulte las propiedades de país en la nube
Se puede acceder a las propiedades de país en el Portal de Cloud a través del siguiente enlace:
https://portal.retailforce.cloud/information/fiscal-country
Para acceder a las fiscalCountryProperties, debe haber iniciado sesión en el portal.
Consultar las propiedades de país en el client
Las propiedades de los países también pueden consultarse mediante el programa, lo que permite al sistema reaccionar ante distintas propiedades de los países en el programa de caja registradora.
Ejemplo: un tipo de documento no está permitido en un país y, por lo tanto, no es compatible.
Consulta mediante implementación directa (NuGet)
Para consultar todas las propiedades de país existentes de todos los países, puede llamarse al siguiente método:
List<IFiscalCountryProperties> TrustedFiscalModul.GetFiscalCountryPropertiesList()Consulta a través del cliente
Servicio REST
En el servicio REST existen dos puntos finales para consultar las propiedades de los países:
GET /api/v1/information/countryPropertiesEste método se puede utilizar para consultar las propiedades de un país concreto.
/api/v1/information/client/{clientId}/countryPropertiesEste método se puede utilizar para consultar las propiedades de un país para un cliente.
Cliente del Servicio Fiscal
En el cliente del Servicio Fiscal (.NET Standard 2.0 y .NET Framework 2) existen los siguientes métodos para consultar las propiedades de un país.
FiscalCountryProperties GetFiscalCountryProperties(FiscalCountry fiscalCountry)Este método puede utilizarse para consultar las propiedades de un país.
FiscalCountryProperties GetFiscalCountryProperties(Guid clientId)Este método puede utilizarse para consultar las propiedades de un país para un cliente.
fiscalCountryProperties - Explicación
Las propiedades «fiscalCountryProperties» contienen datos de carácter meramente informativo, así como información relevante para la implementación.
Los datos informativos se identifican con la marca «INFO» en la columna «Tipo». Los datos que deben tenerse en cuenta durante la implementación se identifican con la marca «RFI» (relevante para la implementación).
| fiscalCountryProperties | Tipo |
Descripción |
| fiscalCountry | INFO |
indica el país correspondiente. Si se consultan las fiscalCountryProperties mediante la llamada GET /api/v1/information/client/{clientId}/countryProperties, se especifica el país asignado al cliente correspondiente. |
| countryModuleVersion | INFO |
Versión actual del Módulo Fiscal de País de Confianza dentro del middleware (relevante para países en los que debe certificarse una versión específica de software; p. ej., Francia). |
| certificationType | INFO |
Especifica si se requiere la certificación de un componente de fiscalización en un país, o qué es lo que debe certificarse. «obligatorio»: la certificación del sistema anterior (por ejemplo, la caja registradora) es obligatoria. En este caso, la caja registradora debe someterse a un proceso de certificación o homologación. «miniPOS»: la certificación es obligatoria, pero se satisface mediante un componente ya certificado que puede integrarse en el RetailForce Middleware. «notNecessary»: no se requiere certificación del sistema anterior. |
| fiscalLineInterface | RFI |
«true» — En el país correspondiente, los datos deben enviarse línea por línea, por ejemplo, a una impresora fiscal.
«false» — Interfaz basada en documentos (sin impresión línea por línea).
|
| fiscalisationType | INFO |
Especifica el tipo de fiscalización. «fiscalPrinter» — La fiscalización se realiza mediante una impresora fiscal certificada o un sistema de caja registradora fiscal certificado.
«online»: fiscalización mediante los sistemas en línea de las autoridades fiscales locales.
«signature»: fiscalización mediante la firma de los datos del recibo utilizando un certificado digital almacenado en el servicio de fiscalización.
«signatureWithOnline»: fiscalización mediante la generación de firmas y la transmisión de datos en línea a las autoridades fiscales.
|
| Entornos compatibles | RFI |
Especifica qué entorno es compatible: «local»: instalación local del middleware fiscal (en el propio sistema TPV, en el servidor de la tienda, etc.)
«cloud»: el middleware fiscal se encuentra disponible como servicio alojado en la nube en https://fiscalisation.retailforce.cloud/.
|
| supportedPlatformTypes | RFI |
Especifica los sistemas operativos o plataformas compatibles. «linux»
«windows»
«iOS»
«Android»
|
| Legislación compatible | INFORMACIÓN |
Especifica los requisitos legales compatibles y sus versiones. Por ejemplo, para Grecia: «myDATA v1.x.x». |
| tipos de documentos fiscales | RFI |
Tipos de documentos que deben ser «fiscalizados» en el país correspondiente. Por ejemplo, deben ser procesados mediante el componente de hardware prescrito, firmados, etc. Los «documentTypes» incluidos en «fiscalDocumentTypes» se procesan automáticamente (p. ej., se firman) en el país correspondiente por el servicio de fiscalización, conforme a la normativa de fiscalización. Estos tipos de documentos DEBEN transmitirse al servicio de fiscalización del país correspondiente, siempre que el sistema anterior («caja registradora») los admita. |
| Tipos de documentos compatibles | RFI |
Lista de tipos de documentos admitidos en cada país. Además de los «fiscalDocumentTypes», los tipos de documentos que figuran en «supportedDocumentTypes» PUEDEN transmitirse al servicio de fiscalización. Estos tipos de documentos se denominan «no fiscales», es decir, aquellos que no están «fiscalizados» (p. ej., firmados). |
| Tipos de documentos no admitidos | RFI |
Lista de tipos de documentos no admitidos en el país correspondiente. Los «documentTypes» que figuran en «notSupportedDocumentTypes» no pueden transmitirse al servicio de fiscalización en el país correspondiente. Los motivos pueden ser la imposibilidad técnica o normativas y leyes específicas de cada país. Si se envía un «notSupportedDocumentType» al servicio de fiscalización, este responderá con un mensaje de error («¡documentType no admitido!»). El sistema de origen no debe permitir estos tipos de documento en el país en cuestión. |
| tipos de pago admitidos | RFI |
Lista de métodos de pago admitidos (aceptados) en el país correspondiente. Estos métodos de pago pueden utilizarse en el país correspondiente. El sistema upstream solo debe exponer al usuario del punto de venta los métodos de pago admitidos en el país correspondiente. |
| notSupportedPaymentTypes | RFI |
Lista de métodos de pago que no son compatibles (o no están permitidos) en el país correspondiente. El sistema upstream debe omitir los métodos de pago no admitidos en el país correspondiente. |
| overpaymentNotAllowed | RFI |
Lista de métodos de pago (PaymentTypes) para los que no se permite el pago en exceso del importe adeudado en el país en cuestión. Ejemplos: Importe total del recibo = 38,50 EUR
Estas transacciones no están permitidas en algunos países (es decir, no pueden enviarse al sistema de fiscalización). Esto implica que los importes de pago («payment.amount») deben corresponder siempre al total bruto de las partidas («GrossValue» de todas las «positions») y no se pueden transferir importes de pago negativos. |
| tipos de transacciones comerciales admitidos | RFI |
Lista de tipos de casos de negocio admitidos en cada país. Estos casos de negocio pueden utilizarse en el país correspondiente, a diferencia de los «notSupportedBusinessTransactionTypes». |
| notSupportedBusinessTransactionTypes | RFI |
Lista de tipos de casos de negocio que no son compatibles (o no están permitidos) en el país correspondiente. Estos casos de negocio no pueden utilizarse en el país correspondiente y deben ser suprimidos por el sistema de origen y no transmitidos al servicio de fiscalización. |
| definiciones de IVA admitidas | RFI |
Información detallada sobre los tipos de Vat admitidos en cada país. Esta matriz contiene la siguiente información:
|
| companyIdentification | RFI |
Información sobre qué identificadores de empresa deben utilizarse en el país correspondiente. |
| customerDisplayMandatory | RFI |
«no obligatorio»: no es necesario mostrar el cliente (sin obligación). «obligatorio (sin RF)»: la visualización del cliente es obligatoria, pero no se controla a través del RetailForce Middleware. El control lo lleva a cabo automáticamente el sistema de fiscalización correspondiente (por ejemplo, automáticamente mediante la impresora fiscal). «obligatorio (RF)»: es obligatorio utilizar una pantalla de cliente y su control se realiza a través del RetailForce Middleware.
«no permitido»: el uso de una pantalla de cliente está prohibido en este país. |
| terminalSlaveSupported | RFI |
Especifica si los dispositivos de entrada deben estar registrados en el país correspondiente («true» / «false»). Los dispositivos de entrada no constituyen sistemas de registro autónomos. Para obtener más información, consulte: Arquitecturas de los sistemas de registro electrónico (EAS) |
| auditLogMandatory | RFI |
«true»: en el país correspondiente existe la obligación de mantener un registro técnico (audit log) (en este caso, incluido en la licencia RF).
«false»: no existe la obligación de llevar un registro técnico (no incluido en la licencia).
|
| mustRecordDocumentReprint | RFI |
«true»: en el país correspondiente, la reimpresión de un documento debe registrarse de forma obligatoria.
«false»: la reimpresión de un documento no debe registrarse como obligatoria. |
| reprintAllowedDomain | RFI |
«terminal»: el documento solo podrá reimprimirse en el mismo punto de venta en el que se emitió el documento original. «store» — Las reimpresiones de un documento solo pueden realizarse en la misma sucursal o tienda en la que se emitió el documento original.
«all» — La reimpresión de un documento podrá realizarse tanto en otra caja registradora como en otra sucursal o tienda de la misma empresa.
|
| mustSendClosingPerDay | RFI |
«true» — Se debe generar un cierre diario (informe Z) una vez al día.
«false»: no es obligatorio realizar un cierre diario. |
| maximumHourIntervalForClosing | RFI |
Indica el intervalo de tiempo transcurrido desde el último cierre diario en el que debe tener lugar el siguiente cierre diario (p. ej., en un plazo de 24 horas). Una vez transcurrido este intervalo, el servicio de fiscalización rechaza todos los documentos, excepto el cierre diario («documentType»: «[99] = EndOfDay»), con el estado HTTP 400 hasta que se haya almacenado un cierre diario. No se aplica ningún límite antes del primer cierre diario. «-1»: no establecido. |
| returnAndSaleBehavior | RFI |
Especifique si las ventas y las devoluciones pueden registrarse simultáneamente en un recibo (documento). «oneReceiptAllowed» — permitido (las ventas y las devoluciones pueden figurar mezcladas en un mismo recibo).
«oneReceiptAllowedPerVatRate»: las ventas y las devoluciones pueden registrarse en un único (el mismo) recibo siempre que los totales brutos de todos los tipos de Vat del recibo tengan el mismo signo (todos positivos o todos negativos). «multiReceipt»: las ventas y las devoluciones deben registrarse en recibos distintos.
«NoReturnAllowed»: en el país correspondiente, no es posible tramitar las devoluciones a través del sistema de fiscalización. En estos países, las devoluciones suelen gestionarse mediante formularios especiales o similares en el departamento de contabilidad. |
| returnDomainAllowed | RFI |
¿En qué punto de venta pueden devolverse los artículos comprados? «terminal»: los artículos solo pueden devolverse en la misma caja (emisión del comprobante) en la que se realizó la venta original. «store» — Los artículos solo pueden devolverse en la misma sucursal o tienda (punto de emisión del recibo) en la que se realizó la venta original. «all» — Los artículos también pueden devolverse en otras sucursales de la misma empresa. |
| returnReferenceBehavior | RFI |
Referencia del documento para devoluciones «single» — En el caso de las devoluciones, solo se puede hacer referencia a UN ÚNICO documento anterior (documento de venta de los servicios o bienes devueltos).
«multiple»: en caso de devoluciones, se pueden hacer referencias a varios documentos anteriores (varios comprobantes de venta si se devuelven varios servicios o bienes procedentes de varias compras).
|
| printFiscalDocumentNumber | RFI |
Especifica si el elemento «fiscalDocumentNumber» de la «fiscalResponse» del país correspondiente debe imprimirse en los documentos.
|
| taxFreeVat |
|
|
| getCloudArchiveAccessLicense |
|
Devuelve la licencia necesaria para el archivo en la Cloud de datos fiscales. |
| surchargesPossible | RFI |
«true»: en el país correspondiente, se permiten recargos sobre bienes o servicios.
«false»: no se permiten recargos en los precios. |
| trainingModeAllowed | RFI |
Indica si el servicio de fiscalización del país correspondiente admite el modo de formación o de demostración «true» — permitido.
«false»: no se admite el modo de formación o demostración. El servicio de fiscalización rechaza todos los documentos con «IsTraining»: true (error de validación: «No se admiten recibos de formación en este país»). |
| netValuePositionCalculation | RFI |
«true»: la suma de las partidas individuales se calcula a partir del importe neto (NetValue) (p. ej., Québec/Canadá). «false»: la suma de las partidas individuales se calcula a partir del importe bruto (GrossValue) (valor por defecto). |
| mustSendCanceledPosition | RFI |
«true» — Las partidas que se hayan introducido pero que posteriormente no se incluyan en el documento deben transmitirse en la payload (JSON). «false»: Las partidas que se hayan introducido pero que posteriormente no se incluyan en el documento no es necesario transmitirlas. Nota: Para obtener más información, consulte el artículo «Envío de posiciones de partidas eliminadas». |
| startDocumentType | RFI |
Especifica el tipo de documento inicial en el país correspondiente. Solo es relevante si el sistema de origen NO utiliza la función GET /api/v1/transactions/document/{clientId}/start durante la inicialización y genera él mismo el documento inicial correspondiente. |
| supportedPayOutTypes | RFI |
Lista de tipos de pago admitidos en el país correspondiente. Los elementos enumerados en «supportedPayOutTypes» pueden o deben especificarse para los pagos («documentType»: «[10] = PayOut» y «BusinessTransactionType»: «[10] = PayOut»). |
| notSupportedPayOutTypes | RFI |
Lista de tipos de pago que no están admitidos (o no están permitidos) en el país en cuestión. |
| fiscalModuleCalculatesTaxRates | RFI |
Indica si los tipos del Vat son calculados por el módulo de fiscalización correspondiente del país. «true»: el módulo de fiscalización calcula los tipos del Vat. «false»: la caja registradora debe calcular los tipos del Vat. |
| Expresión regular de caracteres válidos para el número de tienda | RFI |
Expresión regular permitida para el número de tienda (número de sucursal) |
| terminalNumberValidCharsRegex | RFI |
Expresión regular permitida para el número de terminal (número de caja registradora) |
| fiscalRegions | RFI |
Indicación de las regiones fiscales, si procede en el país en cuestión. |
| decimalesDelImporte | RFI |
Especifica si deben incluirse decimales en el documento JSON enviado al middleware fiscal al transmitir importes o totales, y en tal caso, cuántos. Se aplica a todas las especificaciones de valores de la payload («GrossValue», «NetValue», «TaxValue», «Amount», etc.) |
| entityParameters |
|
Especifica qué parámetros deben almacenarse para cada entidad del portal. |
| formularios legales | RFI |
Lista de formas jurídicas de las empresas disponibles en el país. |
| clasificación-de-tipos-de-artículos-obligatoria | RFI |
En algunos países se requiere una especificación más detallada de determinados artículos. Si el valor de esta propiedad es «true», los valores especificados en `supportedItemTypeClassification` deben establecerse para los artículos pertinentes en el país correspondiente (la propiedad ItemTypeClassification debe configurarse en consecuencia en el objeto «positions»). |
| supportedItemTypeClassification | RFI |
Especifica qué partidas deben marcarse de forma especial en el país correspondiente (la propiedad `ItemTypeClassification` debe configurarse en consecuencia en el objeto `positions`). |
| documentTypeBusinessTransactionTypeSupport | RFI |
Información sobre qué BusinessTransactionTypes pueden combinarse con qué documentTypes. |
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.