Descripción general

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

• Entidades Restaurant: Los restaurantes a los que brindas servicios.
• Entidades Service: Los horarios, la ubicación y las condiciones de tu servicio.
• Entidades Menu: Detalles del menú de cada restaurante.

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

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

Nota: Para obtener información sobre cómo generar bibliotecas cliente para tus feeds, consulta la sección Generar bibliotecas cliente de la página Herramientas.

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 te ayuden a buscar un restaurante.

• Formato de archivo de datos: Los archivos de datos deben tener el formato de archivo JSON separado por líneas nuevas (formato ndjson).

• Valores de fecha y hora: En el caso de las propiedades que requieren un valor DateTime o Time, usa los formatos especificados en Formatos de fecha y hora. 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 las 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 IDs: Mantén la estabilidad de los IDs. No uses UUID ni cambies o generes IDs de forma aleatoria entre cargas de feeds. Esto permite una asistencia más fácil para los problemas relacionados con las entidades.

• 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ódigo cliente en la sección Herramientas está disponible para validar tu feed de datos de extremo a extremo de pedidos.