Visão geral

A estrutura do feed de dados de ponta a ponta de pedidos é definida pelo esquema de inventário relacional. O feed de dados de ponta a ponta do pedido consiste nas seguintes entidades de nível superior:

• Entidades Restaurant: quais restaurantes você atende.
• Entidades Service: tempo, local e condições do serviço.
• Entidades Menu: detalhes do cardápio de cada restaurante.

O diagrama a seguir mostra como as entidades Service, Restaurant e Menu representam um único restaurante:

Figura 1:relação geral das entidades de feed de dados de pedidos de ponta a ponta: serviço, restaurante e cardápio.

Observação: para saber como gerar bibliotecas de cliente para seus feeds, consulte a seção Gerar bibliotecas de cliente da página "Ferramentas".

Diretrizes gerais

• Restaurantes por arquivo: cada arquivo de dados precisa representar um restaurante com as entidades Service e Menu relacionadas. Use nomes de arquivo que podem ajudar você a pesquisar um arquivo de um restaurante.

• Formato do arquivo de dados: os arquivos de dados precisam ser formatados em arquivos JSON separados por nova linha (formato ndjson).

• Valores de data/hora e hora: para propriedades que exigem um valor DateTime ou Time, use os formatos especificados em Formatos de data/hora e hora. Por exemplo, 2017-05-01T06:30:00+05:30 para DateTime e T08:08:00+05:30 para Time.

• IDs: use uma propriedade @id para identificar todas as entidades únicas em um tipo de entidade. O tamanho máximo é de 300 caracteres. Um @id é um identificador exclusivo da entidade desse tipo, mas, entre as entidades, os IDs podem se sobrepor. Por exemplo, suponha que você defina uma entidade Service com a propriedade @id definida como a16. Não é possível criar outra entidade Service com um @id de a16. No entanto, é possível usar a16 como o valor @id de uma entidade Menu.

• Geração de IDs: mantenha os IDs estáveis. Não use UUIDs nem altere/randomize IDs entre os uploads de feed. Isso facilita o suporte a problemas relacionados a entidades.

• Valores nulos: não use o valor null no lugar de objetos. Se um objeto for opcional, ele precisa ser omitido do feed.

Bibliotecas de cliente

O gerador de código do cliente na seção "Ferramentas" está disponível para validar seu feed de dados de ponta a ponta de pedidos.