Order-to-Cash input fields

Introdução

Esta seção contém uma visão geral dos campos para cada uma das tabelas de entrada de Order-to-Cash. Os campos são listados para cada entidade. Para cada campo, são exibidos o nome e um tipo de dados. Além disso, é indicado se o campo é obrigatório caso a entidade esteja incluída no processo Order-to-Cash.

Observação:

As tabelas opcionais devem fazer parte da entrada, mas não podem conter registros.

Quando um campo é obrigatório, não deve conter valores NULL .

Entidade	Tabelas	Obrigatório S/N
Ordem de venda	Sales_orders_base_raw Sales_order_items_base_raw	Y
Entregas	Deliveries_base_raw Delivery_items_base_raw	N
Fatura	Invoices_base_raw Invoice_items_base_raw Invoide_cancellations_base_raw	N
Contabilidade	Accounting_documents_base_raw	N
Payment	Payments_base_raw	N
Eventos*	Event_base_raw	Y

*) Events não é uma entidade do processo Order-to-Cash, mas uma tabela de eventos é obrigatória para um funcionamento correto do app de processo Order-to-Cash.

A ilustração a seguir mostra as relações entre entidades de Order-to-Cash.

Importante:

Os nomes de tabelas e de campos diferenciam maiúsculas de minúsculas. Certifique-se sempre de que os nomes dos campos (cabeçalhos de coluna) em seu conjunto de dados correspondam aos nomes dos campos (em inglês) nas tabelas abaixo e que os nomes dos arquivos correspondam aos nomes das tabelas.

Field types

Abaixo há uma visão geral dos diferentes tipos de campos e suas configurações de formato padrão.

Tipo de campo	Format
boolean	true, false, 1, 0
date	yyyy-mm-dd
datetime	yyyy-mm-dd hh:mm:ss[.ms], em que [.ms] é opcional. Consulte a documentação oficial da Microsoft se quiser alterar o formato da data.
double	Separador decimal: . (ponto) Separador de milhar: nenhum
integer	Separador de milhar: nenhum
text	N/A

Ordem de venda

Sales_orders_base_raw

Abaixo há uma visão geral dos campos da tabela Sales_orders_base_raw.

Name	Tipo	Obrigatório S/N	Description
Sales_order_ID	text	Y	O identificador exclusivo da ordem de venda.
Company	text	N	A empresa para a qual a ordem de venda é criada.
Customer	text	N	O cliente para o qual o pedido de venda é criado.
Customer_country	text	N	O país associado ao cliente.
Customer_region	text	N	A região associada ao cliente.
Distribution_channel	text	N	O canal de distribuição associado ao pedido de venda.
Division	text	N	A divisão associada ao pedido de venda.
Requested_delivery_date	date	N	A data de entrega solicitada pelo cliente para o pedido de venda.
Sales_group	text	N	O grupo de vendas associado à ordem de venda.
Sales_office	text	N	O escritório de vendas associado à ordem de venda.
Sales_order_creator	text	N
Sales_order_type	text	N	O tipo de ordem de venda da ordem de venda.
Sales_organization	text	N	A organização de vendas do pedido de venda.

Sales_order_items_base_raw

Abaixo há uma visão geral dos campos da tabela Sales_order_items_base_raw.

Name	Tipo	Obrigatório S/N	Description
Sales_order_item_ID	text	Y	O identificador exclusivo do item da ordem de venda.
Sales_order_ID	text	N	O identificador exclusivo da ordem de venda.
Category	text	N	A categoria do item do pedido de venda.
Creation_date	date	N	A data em que o item do pedido de venda é criado.
Incoterms	text	N	Os Incoterms associados ao item do pedido de venda.
Latest_expected_delivery_date	date	N	A última data de entrega esperada de (partes de) o item do pedido de venda.
Material	text	N	O material vendido.
Material_group	text	N	A categorização do material vendido.
Payment_terms	text	N	As condições de pagamento associadas ao item do pedido de venda.
Plant	text	N	A planta associada ao item da ordem de venda.
Profit_center	text	N	O centro de lucro associado ao item da ordem de venda.
Quantity	text	N	A quantidade e unidade de medida vendida.
Sales_order_item	text	N	Um nome amigável para identificar o item do pedido de venda
Sales_order_item_creator	text	N
Shipping_point_country	text	N	O país onde as mercadorias são entregues associadas ao item do pedido de venda.
Storage_location	text	N	Local de armazenamento associado ao artigo da encomenda.
Value	double	N	Um valor monetário relacionado ao item do pedido de vendas.

Entrega

Deliveries_base_raw

Abaixo há uma visão geral dos campos da tabela Deliveries_base_raw.

Name	Tipo	Obrigatório S/N	Description
Delivery_ID	text	Y	O identificador exclusivo de cada entrega.
Company	text	N
Delivery_creator	text	N
Delivery_date	date	N
Delivery_type	text	N
Incoterms	text	N
Planned_delivery_date	date	N
Sales_organization	text	N
Shipping_conditions	text	N
Staging_area	text	N
Warehouse_number	text	N

Delivery_items_base_raw

Abaixo há uma visão geral dos campos da tabela Delivery_items_base_raw.

Name	Tipo	Obrigatório S/N	Description
Delivery_item_ID	text	Y	O identificador exclusivo do item de entrega.
Delivery_ID	text	N*	O identificador exclusivo de cada entrega.
Sales_order_item_ID	text	N*	O identificador exclusivo do item da ordem de venda.
Delivery_item_creator	text	N
Category	text	N
Delivery_item_is_invoiced	boolean	N	Indica se o item do pedido de venda está liberado para faturamento.
Delivered_quantity	text	N
Material	text	N
Material_group	text	N
Plant	text	N
Storage_location	text	N
Value	double	N

• Caso deseje incluir eventos relacionados a outras entidades que não o pedido de venda nos gráficos do processo, os campos Delivery_ID e Sales_order_item_ID são obrigatórios.

Fatura

Invoices_base_raw

Abaixo há uma visão geral dos campos da tabela Invoices_base_raw.

Name	Tipo	Obrigatório S/N	Description
Invoice_ID	text	Y	O identificador exclusivo da fatura.
Baseline_date	date	N
Company	text	N
Discount	double	N
Discount_percentage_1	double	N
Discount_percentage_2	double	N
Discount_period_1	integer	N
Discount_period_2	integer	N
Fiscal_year	text	N
Incoterms	text	N
Invoice_creator	text	N
Invoice_date	date	N
Invoice_type	text	N
Net_payment_period	integer	N	Prazo líquido de pagamento da fatura em dias.
Payment_method	text	N
Payment_terms	text	N
Posting_date	date	N
Sales_organization	text	N
Shipping_conditions	text	N

Invoice_items_base_raw

Abaixo há uma visão geral dos campos da tabela Invoice_items_base_raw.

Name	Tipo	Obrigatório S/N	Description
Invoice_item_ID	text	Y	O identificador exclusivo do item da fatura.
Delivery_item_ID	text	N*	O identificador exclusivo do item de entrega.
Invoice_ID	text	N*	O identificador exclusivo da fatura.
Category	text	N
Invoice_item_creator	text	N
Invoice_item_is_cancelled	boolean	N	Indica se o item da nota fiscal está cancelado.
Invoice_item_is_released_into_accounting	boolean	N	Indica se o item da fatura é faturável.
Invoiced_quantity	text	N
Material	text	N
Material_group	text	N
Plant	text	N
Value	double	N

• Caso deseje incluir eventos relacionados a outras entidades que não o pedido de venda nos gráficos do processo, os campos Invoice_ID e Delivery_item_ID são obrigatórios.

Invoice_cancellations_base_raw

Abaixo há uma visão geral dos campos da tabela Invoice_cancellations_base_raw.

Name	Tipo	Obrigatório S/N	Description
Invoice_cancellation_ID	text	Y	O identificador exclusivo do cancelamento da fatura.
Invoice_ID	text	N*	O identificador exclusivo da fatura cancelada.
Company	text	N
Fiscal_year	text	N
Incoterms	text	N
Invoice_cancellation_creator	text	N
Invoice_date	date	N
Invoice_type	text	N
Sales_organization	text	N
Shipping_conditions	text	N

• Se quiser incluir eventos relacionados a outras entidades que não a ordem de venda nos gráficos do processo, o campo Invoice_ID é obrigatório.

Contabilidade

Accounting_documents_base_raw

Abaixo há uma visão geral dos campos da tabela Accounting_documents_base_raw.

Name	Tipo	Obrigatório S/N	Description
Accounting_document_ID	text	Y	O identificador exclusivo do documento contábil.
Invoice_ID	text	N*	O identificador exclusivo da fatura.
Accounting_document_creator	text	N
Accounting_document_is _cancelled	boolean	N	Indica se o documento contábil está cancelado.
Accounting_document_is _cleared	boolean	N	Indica se o documento contábil foi tratado e está encerrado.
Baseline_date	date	N
Company	text	N
Discount	double	N
Discount_percentage_1	double	N
Discount_percentage_2	double	N
Discount_period_1	integer	N
Discount_period_2	integer	N
Document_date	date	N
Document_type	text	N
Fiscal_year	text	N
Net_payment_period	integer	N
Payment_date	date	N
Payment_method	text	N
Payment_status	text	N
Payment_terms	text	N
Posting_date	date	N
Transaction_type	text	N
Value	double	N

• Se quiser incluir eventos relacionados a outras entidades que não a ordem de venda nos gráficos do processo, o campo Invoice_ID é obrigatório.

Payment

Payments_base_raw

Abaixo há uma visão geral dos campos da tabela Payments_base_raw.

Name	Tipo	Obrigatório S/N	Description
Payment_ID	text	Y	O identificador exclusivo do pagamento.
Accounting_document_ID	text	N*	O identificador exclusivo do documento contábil.
Company	text	N
Fiscal_year	text	N
Payment_creator	text	N
Payment_is_complete	boolean	N
Payment_is_debit	boolean	N
Value	double	N

• Se quiser incluir eventos relacionados a outras entidades que não a ordem de venda nos gráficos do processo, o campo Accounting_document_ID é obrigatório.

Events

Events_base_raw

A tabela Events_base_raw contém todos os logs de subeventos para todas as entidades. Abaixo está uma visão geral dos campos da tabela Events_base_raw .

Name	Tipo	Obrigatório S/N	Description
Activity	text	Y	O nome do evento. Isso descreve a etapa no processo.
Accounting_document_ID	text	Y	O identificador exclusivo do documento contábil.
Delivery_ID	text	Y	O identificador exclusivo de cada entrega.
Delivery_item_ID	text	Y	O identificador exclusivo do item de entrega.
Event_end	datetime	Y	O carimbo de data/hora associado ao fim da execução do evento .
Invoice_ID	text	Y	O identificador exclusivo da fatura.
Invoice_item_ID	text	Y	O identificador exclusivo do item da fatura.
Invoice_cancellation_ID	text	Y	O identificador exclusivo do cancelamento da fatura.
Payment_ID	text	Y	O identificador exclusivo do pagamento.
Sales_order_ID	text	Y	O identificador exclusivo da ordem de venda.
Sales_order_item_ID	text	Y	O identificador exclusivo do item da ordem de venda.
Activity_category	text	N	O tipo de atividade que ocorre (por exemplo, alterar, definir/remover bloco)
Activity_order	integer	N	O número que define em qual ordem as atividades são executadas caso tenham o mesmo fim do evento.
Activity_trigger	text	N	Campo descrevendo o motivo da atividade executada
Automated	boolean	N	Indicador se o evento é executado manualmente ou automatizado.
Department	text	N	O departamento que executou o evento
Event_detail	text	N	Informações relacionadas ao evento.
User	text	N	O usuário que executou o evento.
User_function	text	N	A função associada ao usuário.
User_type	text	N	A categorização do usuário.
Event_cost	double	N	Os custos de execução do evento.
Event_start *	datetime	N	O carimbo de data/hora associado ao início da execução do evento.
Event_processing_time	integer	N	O horário da execução do evento (em milissegundos).

Se Event_start e Event _end estiverem definidos em seu conjunto de dados, a duração do evento será conhecida. Isso será usado para calcular o tempo de processamento dos eventos. Se apenas o final Event_end for definido, o tempo de transferência será calculado como a diferença entre Event_end anterior e o Event_end. Event_start só é considerado se cada registro no conjunto de dados contiver um valor não nulo .

Importante:

Se você deseja usar Event_cost e/ou Event_start no Order-to-Cash, deve adicionar esses campos ao seu conector .mvp e usar DataBridgeAgent para carregar os dados em seu aplicativo de processo Order-to-Cash .

Consulte Carregamento de dados usando o DataBridgeAgent.

Certifique-se de adicionar o conector ao DataBridgeAgent. Consulte Adição de um conector personalizado ao DataBridgeAgent.

Observação:

Espera-se que para cada registro seja preenchido exatamente um dos campos ID , que é o da entidade na qual o evento ocorre. Os outros campos ID podem estar vazios.

Além dos campos padrão obrigatórios (Activitye Event_end), uma entidade IDé obrigatória. Esse campo depende da entidade da qual o evento faz parte.