Daterium System

Actualizaciones

Descripción general

Devuelve el listado de actualizaciones de categorías, productos o referencias.

Usos:

Sincronización de información.

URL de llamada

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

Parámetros

Parámetro	Obligatorio	Descripción
userID	si	Clave proporcionada por Daterium System y que identifica al comercio.
entidad	si	Puede ser 'categorias', 'productos' o 'referencias'. Permite indicar la entidad de la cuál obtener la información.
fecha	no	Fecha desde la cual se quiere obtener el listado de eliminados. Debe ir en el formato siguiente: año-mes-dia (ejemplo: 2016-12-01).
cif[]	no	Filtro sobre el CIF del proveedor. Es un array, por lo que se debe repetir el parámetro tantas veces como proveedores distintos queremos filtrar.
cursor	no	Identificador de paginación basado en cursor. Debe enviarse el valor 'nextCursor' obtenido en la respuesta anterior para recuperar la siguiente página de resultados. Si no se indica, la consulta comienza desde el inicio.
limite	no	Se usa para paginación (tipo cursor). Es el número de elementos que devolverá la API. El valor por defecto es 500 y el máximo es 1000

DTD del XML devuelto

< !ELEMENT actualizaciones (paginacion, (categorias | productos | referencias)) >

< !ELEMENT paginacion (nextCursor, hasMore, limite) >
< !ELEMENT nextCursor (#PCDATA) >
< !ELEMENT hasMore (#PCDATA) >
< !ELEMENT limite (#PCDATA) >

< !ELEMENT categorias (categoria+) >

< !ELEMENT categoria (
    catID,
    fecha_alta,
    ultima_modificacion,
    estado,
    estado_fecha
) >

< !ELEMENT productos (producto+) >

< !ELEMENT producto (
    pID,
    fecha_alta,
    ultima_modificacion,
    estado,
    estado_fecha
) >

< !ELEMENT referencias (referencia+) >

< !ELEMENT referencia (
    refID,
    pID,
    fecha_alta,
    ultima_modificacion,
    estado,
    estado_fecha
) >

< !ELEMENT catID (#PCDATA) >
< !ELEMENT pID (#PCDATA) >
< !ELEMENT refID (#PCDATA) >
< !ELEMENT fecha_alta (#PCDATA) >
< !ELEMENT ultima_modificacion (#PCDATA) >
< !ELEMENT estado (#PCDATA) >
< !ELEMENT estado_fecha (#PCDATA) >

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 para categorías
Llamada del ejemplo: https://api.dateriumsystem.com/actualizaciones_xml.php?userID=_MI_CODIGO_API_&entidad=categorias&limite=5

<?xml version='1.0' encoding='UTF-8'?>
<actualizaciones>
	<paginacion>
		Información de la paginación.
		<nextCursor></nextCursor>
		nextCursor devuelve una cadena de texto para pasar en el parámetro 'cursor' para obtener la siguiente página.
		<hasMore></hasMore>
		Vacío si no hay más resultados. Devuelve 1 si hay más resultados.
		<limite>5</limite>
		El límite de la página.
	</paginacion>
	<categorias>
		Listado de categorías.
		<categoria>
			<catID>1000532</catID>
			Identificador único de la categoría en Daterium.
			<fecha_alta>2021-04-05T12:42:35+0200</fecha_alta>
			Fecha de alta de la categoría.
			<ultima_modificacion>2025-07-21T08:17:02+0200</ultima_modificacion>
			Fecha de última modificación de la categoría.
			<estado>activo</estado>
			Estado de la categoría: activo / eliminado.
			<estado_fecha>2021-04-05T12:42:35+0200</estado_fecha>
			Fecha del estado de la categoría.
		</categoria>
		<categoria>
			<catID>1000533</catID>
			<fecha_alta>2021-04-05T12:42:35+0200</fecha_alta>
			<ultima_modificacion>2025-05-06T01:55:17+0200</ultima_modificacion>
			<estado>activo</estado>
			<estado_fecha>2021-04-05T12:42:35+0200</estado_fecha>
		</categoria>
		<categoria>
			<catID>1000534</catID>
			<fecha_alta>2021-04-05T12:42:35+0200</fecha_alta>
			<ultima_modificacion>2025-05-06T01:55:17+0200</ultima_modificacion>
			<estado>activo</estado>
			<estado_fecha>2021-04-05T12:42:35+0200</estado_fecha>
		</categoria>
		<categoria>
			<catID>1000535</catID>
			<fecha_alta></fecha_alta>
			Fecha de alta vacía para categorías eliminadas.
			<ultima_modificacion></ultima_modificacion>
			Fecha de última modificación vacía para categorías eliminadas.
			<estado>eliminado</estado>
			La categoría se ha eliminado permanentemente de Daterium.
			<estado_fecha>2023-03-01T10:12:31+0100</estado_fecha>
		</categoria>
		<categoria>
			<catID>1000536</catID>
			<fecha_alta>2021-04-05T12:42:35+0200</fecha_alta>
			<ultima_modificacion>2021-06-08T12:08:01+0200</ultima_modificacion>
			<estado>activo</estado>
			<estado_fecha>2021-04-05T12:42:35+0200</estado_fecha>
		</categoria>
	</categorias>
</actualizaciones>

Ejemplo para productos y filtro por fecha con limite igual a 5
Llamada del ejemplo: https://api.dateriumsystem.com/actualizaciones_xml.php?userID=_MI_CODIGO_API_&fecha=2026-05-13&entidad=productos&limite=5

<?xml version='1.0' encoding='UTF-8'?>
<actualizaciones>
	<paginacion>
		Información de la paginación.
		<nextCursor>lIjoiMjAyNi0xMC0wNyIsImlkIjoiMTAyM</nextCursor>
		nextCursor devuelve una cadena de texto para pasar en el parámetro 'cursor' para obtener la siguiente página.
		<hasMore>1</hasMore>
		Vacío si no hay más resultados. Devuelve 1 si hay más resultados.
		<limite>5</limite>
		El límite de la página.
	</paginacion>
	<productos>
		Listado de productos.
		<producto>
			<pID>1022990</pID>
			Identificador único del producto en Daterium.
			<fecha_alta>2021-04-08T06:12:09+0200</fecha_alta>
			Fecha de alta del producto.
			<ultima_modificacion>2026-10-07T14:30:18+0200</ultima_modificacion>
			Fecha de última modificación del producto.
			<estado>activo</estado>
			Estado del producto: activo / inactivo / eliminado.
			<estado_fecha>2021-04-08T06:12:09+0200</estado_fecha>
			Fecha del estado del producto.
		</producto>
		<producto>
			<pID>1022991</pID>
			<fecha_alta>2021-04-08T06:12:09+0200</fecha_alta>
			<ultima_modificacion>2026-10-07T14:30:18+0200</ultima_modificacion>
			<estado>activo</estado>
			<estado_fecha>2021-04-08T06:12:09+0200</estado_fecha>
		</producto>
		<producto>
			<pID>1022992</pID>
			<fecha_alta>2021-04-08T06:12:09+0200</fecha_alta>
			<ultima_modificacion>2026-10-07T14:30:18+0200</ultima_modificacion>
			<estado>inactivo</estado>
			El producto está inactivo. La información no es accesible. El producto podría volver a estado activo.
			<estado_fecha>2026-10-07T14:30:18+0200</estado_fecha>
		</producto>
		<producto>
			<pID>1022993</pID>
			<fecha_alta></fecha_alta>
			Fecha de alta vacía para productos eliminados.
			<ultima_modificacion></ultima_modificacion>
			Fecha de última modificación vacía para productos eliminados.
			<estado>eliminado</estado>
			La referencia se ha eliminado permanentemente de Daterium.
			El producto (y por tanto sus referencias) se ha eliminado permanentemente de Daterium.
			<estado_fecha>2021-04-08T06:12:09+0200</estado_fecha>
		</producto>
		<producto>
			<pID>1022994</pID>
			<fecha_alta>2021-04-08T06:12:09+0200</fecha_alta>
			<ultima_modificacion>2026-10-07T14:30:18+0200</ultima_modificacion>
			<estado>activo</estado>
			<estado_fecha>2021-04-08T06:12:09+0200</estado_fecha>
		</producto>
	</productos>
</actualizaciones>

Ejemplo para referencias con varios CIFs con limite igual a 5
Llamada del ejemplo: https://api.dateriumsystem.com/actualizaciones_xml.php?userID=_MI_CODIGO_API_&entidad=referencias&cif[]=B12345678&cif[]=B32453423&limite=5

<?xml version='1.0' encoding='UTF-8'?>
<actualizaciones>
	<paginacion>
		Información de la paginación.
		<nextCursor>CJmZWNoYURlc2RlIjoiMjAyNi0xMC0wNyIs</nextCursor>
		nextCursor devuelve una cadena de texto para pasar en el parámetro 'cursor' para obtener la siguiente página.
		<hasMore>1</hasMore>
		Vacío si no hay más resultados. Devuelve 1 si hay más resultados.
		<limite>5</limite>
		El límite de la página.
	</paginacion>
	<referencias>
		Listado de referencias.
		<referencia>
			<refID>2047144</refID>
			Identificador único de la referencia en Daterium.
			<pID>1015304</pID>
			Identificador único del producto en Daterium al que pertenece la referencia.
			<fecha_alta>2021-04-07T03:59:33+0200</fecha_alta>
			Fecha de alta de la referencia.
			<ultima_modificacion>2026-10-07T10:22:04+0200</ultima_modificacion>
			Fecha de última modificación de la referencia.
			<estado>activo</estado>
			Estado del producto al que pertenece la referencia: activo / inactivo / eliminado.
			<estado_fecha>2021-04-07T03:59:26+0200</estado_fecha>
			Fecha del estado de la referencia.
		</referencia>
		<referencia>
			<refID>2047145</refID>
			<pID>1015304</pID>
			<fecha_alta></fecha_alta>
			Fecha de alta vacía para referencias eliminadas.
			<ultima_modificacion></ultima_modificacion>
			Fecha de última modificación vacía para referencias eliminadas.
			<estado>eliminado</estado>
			<estado_fecha>2026-10-07T10:22:06+0200</estado_fecha>
		</referencia>
		<referencia>
			<refID>2047146</refID>
			<pID>1015304</pID>
			<fecha_alta>2021-04-07T03:59:33+0200</fecha_alta>
			<ultima_modificacion>2026-10-07T10:22:08+0200</ultima_modificacion>
			<estado>activo</estado>
			<estado_fecha>2021-04-07T03:59:26+0200</estado_fecha>
		</referencia>
		<referencia>
			<refID>2047147</refID>
			<pID>1015304</pID>
			<fecha_alta>2021-04-07T02:59:33+0200</fecha_alta>
			<ultima_modificacion>2021-04-07T03:59:26+0200</ultima_modificacion>
			<estado>inactivo</estado>
			El producto al que pertenece la referencia está inactivo. La información no es accesible. El producto podría volver a estado activo.
			<estado_fecha>2021-04-07T03:59:26+0200</estado_fecha>
		</referencia>
		<referencia>
			<refID>2047148</refID>
			<pID>1015304</pID>
			<fecha_alta>2021-04-07T03:59:33+0200</fecha_alta>
			<ultima_modificacion>2026-10-07T10:22:37+0200</ultima_modificacion>
			<estado>activo</estado>
			<estado_fecha>2021-04-07T03:59:26+0200</estado_fecha>
		</referencia>
	</referencias>
</actualizaciones>

Log de cambios

05/10/2026 - Se añade la llamada de 'Actualizaciones'.