Descripción general

La estructura de tu feed de datos de extremo a extremo de pedidos se define mediante el esquema del inventario relacional. El feed de datos de Pedidos de extremo a extremo consta de las siguientes entidades de nivel superior:

En el siguiente diagrama, se muestra cómo las entidades Service, Restaurant y Menu representan un solo restaurante:

Diagrama de relación de clase del menú de servicio de restaurante
Figura 1: Relación general de las entidades de feed de datos de extremo a extremo de pedidos: servicio, restaurante y menú.

Lineamientos generales

  • Restaurantes por archivo: Cada archivo de datos debe representar un restaurante con sus entidades Service y Menu relacionadas. Usa nombres de archivo que puedan ayudarte a buscar un archivo para un restaurante.

  • Formato de archivo de datos: Los archivos de datos deben tener formato de archivos JSON separados por saltos de línea (formato ndjson).

  • Valores de DateTime y Time: para propiedades que requieren un valor DateTime o Time, usa los formatos especificados en formatos de DateTime y Time. Por ejemplo, 2017-05-01T06:30:00+05:30 para DateTime y T08:08:00+05:30 para Time.

  • IDs: Usa una propiedad @id para identificar todas las entidades únicas dentro de un tipo de entidad. La longitud máxima es de 300 caracteres. Un @id es un identificador único de la entidad de ese tipo, pero los IDs pueden superponerse entre entidades. Por ejemplo, supongamos que defines una entidad Service con la propiedad @id establecida en a16. No puedes crear otra entidad Service con un @id de a16. Sin embargo, puedes usar a16 como el valor @id de una entidad Menu.

  • Generación de ID: Mantén estables tus ID. No uses UUIDs ni los cambies o aleatorices entre las cargas del feed. Esto facilita la asistencia para los problemas relacionados con la entidad.

  • Valores nulos: No uses el valor null en lugar de objetos. Si un objeto es opcional, debes omitirlo de tu feed.

Bibliotecas cliente

El generador de códigos de cliente de la sección Herramientas está disponible para validar el feed de datos de extremo a extremo de Pedidos.