Daterium System

Últimas modificaciones

Descripción general

Devuelve un listado de referencias que han sido modificadas (o añadidas) tras la fecha indicada.

Usos:

Mostrar un listado de últimas actualizaciones.
Obtener los últimos productos modificados para sincronizaciones de base de datos.

URL de llamada

https://api.dateriumsystem.com/ultimasmodificaciones_xml.php

Parámetros

Parámetro	Obligatorio	Descripción
userID	si	Clave proporcionada por Daterium System y que identifica al comercio.
fecha	no	desde que fecha se quiere obtener el listado de referencias. Debe ir en el formato siguiente: año-mes-dia (ejemplo: 2016-12-01). La fecha máxima es un mes a la fecha actual. Si no se especifica o la fecha es mayor a un mes se devolverán los artículos modificados en la última semana.
lang	no	Código del idioma en el que se devolverán los datos (por defecto en español, código 'es').

DTD del XML devuelto

< !ELEMENT referencias( referencia* ) >

< !ELEMENT referencia(ref, nombre, proveedor ) >
< !ELEMENT nombre( #PCDATA ) >
< !ELEMENT proveedor( #PCDATA ) >
< !ELEMENT ref ( #PCDATA ) >

< !ATTLIST referencias total CDATA #REQUIRED >
< !ATTLIST referencia pID CDATA #REQUIRED >
< !ATTLIST referencia refID CDATA #REQUIRED >
< !ATTLIST referencia ean CDATA #REQUIRED >
< !ATTLIST referencia ultima_modificacion CDATA #REQUIRED >
< !ATTLIST referencia ultima_modificacion_vinyeta CDATA #REQUIRED >
< !ATTLIST proveedor cif CDATA #REQUIRED >

Ejemplo/s y descripción de campos

A continuación mostramos ejemplos de ficheros XML con comentarios en el propio XML.

Los identificadores entre paréntesis (por ejemplo, CAT_003) vinculan esa etiqueta al campo definido en la documentación de soporte.

Ejemplo
Llamada del ejemplo: https://api.dateriumsystem.com/ultimasmodificaciones_xml.php?userID=_MI_CODIGO_API_&fecha=2021-07-01

<?xml version='1.0' encoding='UTF-8'?>
<referencias total='3'>
Listado de referencias. El atributo nos indica que hay 3.
	<referencia refID='127' pID='55' ean='8432198765432' ultima_modificacion='2021-07-05T09:53:20+0200' ultima_modificacion_vinyeta='2021-07-07T08:28:23+0200'>
	Tenemos como atributos el identificador de referencia (refID), el identificador de viñeta (pID), el código EAN de la referencia y las fechas de modificación de la referencia y de la viñeta.
		<ref>ref1</ref>
		(ART_002) Código de referencia.
		<nombre>Producto prueba 1</nombre>
		(VIN_004) Nombre de la viñeta.
		<proveedor cif='B65708240'>Daterium System</proveedor>
		Datos del proveedor del catálogo.
	</referencia>
	<referencia refID='128' pID='55' ean='8432198765433' ultima_modificacion='2021-07-05T09:53:20+0200' ultima_modificacion_vinyeta='2021-07-07T08:28:23+0200'>
		<ref>ref2</ref>
		<nombre>Producto prueba 1</nombre>
		<proveedor cif='B65708240'>Daterium System</proveedor>
	</referencia>
	<referencia refID='231' pID='65' ean='8432198765441' ultima_modificacion='2021-07-05T09:55:40+0200' ultima_modificacion_vinyeta='2021-07-07T08:29:34+0200'>
		<ref>ref5</ref>
		<nombre>Producto prueba 2</nombre>
		<proveedor cif='B65708240'>Daterium System</proveedor>
	</referencia>
</referencias>