Parametrização SCM AZAP @ L.V. Expertise X3

Pré-requisitos

SEEREFERTTO Consulte a docuemntação de Implementação

Gestão do ecrã

Ecrã de registo

Apresentação

A parametrização consiste em indicar :

O directório de trabalho, por defeito, onde devem ser pesquisado os ficheiros a importar e gerados os ficheiros a exportar.
O directório de armazenagem, por defeito, dos ficheiros tratados.
As referências dos pivots de exportações e de importações dando a descrição dos ficheiros ".csv" a tratar, em indicando eventualmente :

- uma seleção para a exportação dos artigos, para o em-curso das encomemdas e para o histórico de venda,
- o número de unidades de acondicionamento para os quais as informações de conversão com unidade de stock são exportados,
- a escolha dos critérios dos artigos e dos estabelecimentos a exportar,
- o nível de agregação dos dados de venda,
- a escolha de suprimir as antigas previsões ou o conjunto das previsões de vendas no momento de importação das previsões de venda.

Fechar

Campos

Os seguintes campos estão presentes neste separador :

Bloco número 1

Identificador (campo ID)

Código de identificação da parametrização de interface.

campo INTIT

Bloco número 2

Tipo de destino (campo TYPEXP)

Directório de trabalho (campo VOLFILWRK)

Directório armazen. (campo VOLFILSTO)

Exportação

Artigos (campo ITMPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro dos Artigos a exportar : produits.csv.
Por defeito, trata-se do pivot SCMAITM.
É possível de filtrar os artigos a exportar em preencendo uma referência de seleção nos campos Seleção artigos

Selecção artigo (campo ITMFOR)

Este campo permite indicar uma referência de seleção dos artigos, que será proposta, por defeito, no momento do lançamento do tratamento de interface.

SEEINFO Apenas sobre os artigos de tipo "Vendido" (informação portada pela categoria de artigo) são exportadas.

Artigos/Conversões (campo ITMTCOPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro Artigos/Conversões a exportar : conversion.csv.
Por defeito, trata-se do pivot SCMAITMTCO.

campo FIL0400

Unids. de acondicionamento (campo FIL04)

A primeira linha do ficheiro Artigos/Conversões contém sistematicamente, para cada um dos artigos, as informações de conversão entre a unidade de venda e a unidade de stock.
De 1 a 4 linhas facultativas suplementares podem ser acrescentadas em ativando as check boxes a assinalar correspondentes, afim de exportar as informações sobre as conversões entre as 4 unidades de acondiconamento e a unidade de stock.

1 (campo PCU0FLG)

2 (campo PCU1FLG)

3 (campo PCU2FLG)

4 (campo PCU3FLG)

Artigos/Critérios (campo ITMCRIPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro dos Artigos/Critérios a exportar : critstr.csv.
Por defeito, trata-se do pivot SCMAITMCRI.

Tipo código (campo ITMCRITYP)

Para cada um dos critérios, é possível de incluir no ficheiro seja o código, seja o literal, seja à vez o código e o literal.

campo FIL0700

Família estatísticas artigo (campo FIL07)

Os critérios famílias estatísticas 1 a 5 são exportados unicamente se as check boxes a assinalar correspondentes são activados.
Quando um critério não foi exportado, a coluna correspondente não está presente no ficheiro.

1 (campo TSICOD0FLG)

2 (campo TSICOD1FLG)

3 (campo TSICOD2FLG)

4 (campo TSICOD3FLG)

5 (campo TSICOD4FLG)

campo FIL0800

Categoria (campo TCLCODFLG)

Este critério está exportado unicamente a check box a assinalar correspondente está activada.
Quando um critério não está exportado, a coluna correspondentes não está presente no ficheiro.

Linha de produto (campo CFGLINFLG)

Gestor (campo PLANNERFLG)

Estab. (campo FCYPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro dos Estabelecimentos a exportar :sites.csv.
Por defeito, trata-se do pivot : SCMACRIFCY.
SEEINFO Em AZAP, os estabelecimentos são dos clientes ou dos depósitos, o ficheiro dos estabelecimentos conterá então as informações sobre os estabelecimentos de armazenagem e sobre os clientes.

Estab./Critérios (campo FCYCRIPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro dos Estabelecimetos/Critérios a exportar : critstrsite.csv.
Por defeito, trata-se do pivot : SCMACRIFCY.
SEEINFO Em AZAP, os estabelecimentos são dos clientes ou dos depósitos, o ficheiro dos estabelecimentos/Critérios conterá então as informações sobre os estabelecimentos de armazenagem e sobre os clientes.

Tipo código (campo FCYCRITYP)

Para cada um dos critérios, é possível de incluir no ficheiro seja o código, seja o literal, seja à vez o código e o literal.

campo FIL1200

País (campo CRYFLG)

Este critério está exportado unicamente a check box a assinalar correspondente está activada.
Quando um critério não está exportado, a coluna correspondentes não está presente no ficheiro.

Categoria (campo BCGCODFLG)

campo FIL1300

Famílias estatíst. clientes (campo FIL13)

1 (campo TSCCOD0FLG)

2 (campo TSCCOD1FLG)

3 (campo TSCCOD2FLG)

4 (campo TSCCOD3FLG)

5 (campo TSCCOD4FLG)

campo FIL1400

Cliente factur. (campo BPCINVFLG)

Este critério está exportado unicamente a check box a assinalar correspondente está activada.
Quando um critério não está exportado, a coluna correspondentes não está presente no ficheiro.

Grupo cliente (campo BPCGRUFLG)

Exports vendas

Nível de agregação (campo SOHGRU)

Botão rádio permitindo de indicar o nível de agregação. O nível de agregação define o reagrupamento dos dados sobre o histórico de vendas e sobre o em-curso encomendas.
Quando Semana ou Mês está seleccionado, é a data de início de semana ou de início de mês que é exportado.

Selecção encomendas (campo SOHFOR)

Este campo permite indicar a referência de uma seleção sobre encomendas que será aplicada sobre o em-curso das encomendas e sobre o histórico de vendas se este histórico provem das encomendas saldadas.
Esta referência pode ser preenchida, por defeito, ao nível da função de parametrização de interface.

Historico de vendas (campo HISSOHPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro dos Histórico das vendas a exportar : ventes.csv.
Por defeito, trata-se do pivot : SCMDHSOH
O histórico das vendas pode-se apoiar :
- seja sobre as encomendas saldadas cuja uma quantidade foi entregue ou facturada, que é possível de filtrar em preenchendo uma referência de seleção no campo Seleção encomendas,
- seja sobre as entregas e as faturas que é possível de filtrar, em preenchendo uma referência de seleção no campo Seleção entr/fact.

Entregas/faturas (campo HISSDHFLG)

Esta check box está assinalada para o indicar que o histórico das vendas provêm das entregas e faturas, que é possível selecionar em registando o código de uma seleção no campo seguinte.
Este histórico se apoia sobre o realizado ou os fluxos reais :
+ As entregas validadas
+ as faturas directas validadas com movimento de stock
+ as faturas "encomendas" validadas com movimento de stock
+ as linhas de fatura "entrega" validadas com movimento de stock sem número de entrega
- as devoluções de entrega
- as notas de crédito diretas validadas com movimento de stock
- as notas de crédito sobre fatura validada com movimento de stock.

SEEINFO Uma encomenda não saldada pode ter já uma quantidade entregue; esta quantidade está tomada em conta no histórico. A quantidade restante a entregar tomado em conta no em-curso encomenda.

Selecção exp/fac (campo SDHFOR)

Este campo é registável unicamente se o histórico das vendas deve provir das entregas e faturas.
Permite indicar a referência de uma fórmula de seleção das entregas e faturas, que será proposto, por defeito, no momento do lançamento do tratamento de interface.

campo FIL0501

campo FIL0502

Encomendas saldadas (campo HISSOHFLG)

Esta check box está assinalada para indicar que o histórico das vendas provêm das encomendas saldadas cuja quantidade foi entregue ou facturada.
Quando uma referência de seleção está registado no campo Seleção encomenda, esta seleção se aplica igualmente ao histórico das vendas.

Em-curso encomendas (campo SOHPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro dos Em-curso das encomemndas a exportar : carnet.csv.
Por defeito, trata-se do pivot : SCMASOH
É possível de filtrar as encomendas não saldadas a exportar em preenchendo uma referência de seleção num campo Selecção encomendas.
SEEINFO No caso onde o histórico de vendas provêm as entregas e faturas, uma encomenda não saldada pode ter uma quantidade já entregue que será tomado em conta no histórico. A quantidade tomada em conta do em-curso corresponde à quantidade restante a entregar.

Importação

Previsões de vendas (campo SOSPIT)

Preencha o código do pivot descrevendo as linhas do ficheiro das Previsões de vendas a importar : previsões.csv.
Por defeito, trata-se do pivot : SCMAHOS

Supressão das previsões por artigo (campo SOSDLTFLG)

Esta check box a assinalar permite de indicar as antigas previsões de cada um dos artigos do ficheiro importado serão suprimidos antes importação das novas.
Ela não pode estar assinalada ao mesmo tempo que a check box Colocação a zero das previsões.

Raz das previsões (campo SOSRAZFLG)

Esta check box a assinalar permite indicar que todas as previsões serão suprimidas antes o tratamento do ficheiro.
Ela não pode ser assinalada ao mesmo tempo que a check box Supressão das previsões por artigo.

Fechar

Fluxo de exportação : X3 --- AZAP
Fluxo de importação : AZAP --- X3
Pontos de entrada

Princípios de funcionamento

O tratamento por interface se efectua pelo meio de ficheiros ".csv"

Informações gerais sobre os ficheiros

Formato : ".csv"
Tipo : ASCII (modificável por ponto de entrada, ver aqui)
Os campos são de comprimento variável com separador ";" (modificável por ponto de entrada, ver aqui)
Os números têm como separador decimal : o ponto
As datas são registadas sob a forma "AAAAMMDDHHmm" ou "AAAAMMDD"
As durações são exprimidas em horas
Os boleanos podem tomar como valor : seja 0 (falso), seja 1 (verdade)
Os ficheiros são dos ficheiros DOS (caracteres de fim de linhas : \013\010 ou \r\n).
Os ficheiros têm as entidades.

A descrição das linhas cada um dos ficheiros está dado por um Pivot indicando a ordem das zonas, o seu tamanho e descrevendo a sua alimentação (directamente via as zonas de tabelas ou via as funções).

O nome dos ficheiros, sua descrição assim que os pivots utilizados por defeito são indicados a seguir.

SEEINFO Informações não transmitidas

As valorizações : elas não são geradas neste interface. Nenhuma informação sobre os montantes, as divisas (também sobre os artigos que sobre as vendas) não será transmitida em standard, via esta interface.
Os eventos excepcionais, quer dizer os fenómenos não sitemáticos que perturbam as vendas (exemplo : as promoções).

Fluxo de exportação : X3 --- AZAP

Ficheiros esperados		Pivots
produits.csv	Artigos/Produtos	SCMAITM
conversion.csv	Artigos / Conversões	SCMAITMTCO
critstr.csv	Artigos / Critérios	SCMAITMCRI
sites.csv	Estabelecimentos :	SCMAFCY
critstrsite.csv	Estabelecimentos / Critérios	SCMACRIFCY
ventes.csv	Histórico de vendas	SCMAHSOH
carnet.csv	Em-curso encomendas / Livro de contas das encomendas	SCMASOH

Fluxo de importação : AZAP --- X3

Ficheiros esperados		Pivots
previsions.csv	Previsões de vendas	SCMASOS

Pontos de entrada

O ponto de entrada PIVOTSFILE do tratamento CONNECTFCT permite modificar o tipo de código dos ficheiros e o separador de colunas.

Artigos : produits.csv
Artigos / Conversões : conversion.csv
Artigos / Critérios : critstr.csv
Estabelecimentos : sites.csv
Estabelecimentos / Critérios : critstrsite.csv
Histórico de vendas : ventes.csv
Em-curso encomendas : carnet.csv

Descriptivo dos ficheiros exportados depois Sage X3

Artigos : produits.csv

Pivot : SCMAITM

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Código Host Produto	A	20	Não		ITMMASTER	ITMREF	Artigo	Não
	2	Literal artigo	A	30	Sim		ITMMASTER	ITMDES1 :	Designação 1	Não
	3	Título 2 artigo	A	30	Sim		ITMMASTER	ITMDES2	Designação 2	Não
	4	Unidade de venda	A	3	Sim		ITMMASTER	SAU	Unidade de venda	Não

Observações :

O cabeçalho do ficheiro está constituido com os códigos colunas parametrizados sobre o pivot.
Apenas os artigos de tipo "Vendidos" (informação pela categoria do artigo) são exportados.
A parametrização autoriza o registo de uma seleção de artigos : para os artigos seleccionados, as informações de conversão assim que os critérios são exportados nos ficheiros separados : conversion.csv e critstr.csv

Artigos / Conversões : conversion.csv

Pivot : SCMAITMTCO

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Código Host Produto	A	20	Não		ITMMASTER	ITMREF	Artigo	Não
	2	Unidade 1	A	3	Não		ITMMASTER	WUOM1		Não
	3	Unidade 2	A	3	Não		ITMMASTER	WUOM2		Não
	4	Coeficiente :	N		Não		ITMMASTER	WCOEUOM		Não

Observações :

O cabeçalho do ficheiro está constituido com os códigos colunas parametrizados sobre o pivot.
Para cada artigo, o ficheiro contém :

- Uma primeira linha com as informações de conversão entre a unidade de venda e a unidade de stock. Esta linha está sempre presente mesmo se a unidade de venda de stock são idênticos.

- Das linhas facultativas sobre as conversões entre as 4 unidades de acondicionamento e a unidade de stock, em função da parametrização efectuada.

Artigos / Critérios : critstr.csv

Pivot : SCMAITMCRI

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Código Host Produto	A	20	Não		ITMMASTER	ITMREF	Artigo	Não
	2	Estatuto AZAP (1)	A		Não		ITMMASTER	WAZAPSTA	Estatuto AZAP	Não
	3	Estatuto artigo (2)	A		Não		ITMMASTER	ITMSTA	Estatuto artigo	Não
	4	Família estatística 1	A		Sim		ITMMASTER	WTSICOD0	Família estat 1	Não
	5	Família estatística 2	A		Sim		ITMMASTER	WTSICOD1	Família estat 2	Não
	6	Família estatística 3	A		Sim		ITMMASTER	WTSICOD2	Família estat 3	Não
	7	Família estatística 4	A		Sim		ITMMASTER	WTSICOD3	Família estat 4	Não
	8	Família estatística 5	A		Sim		ITMMASTER	WTSICOD4	Família estat 5	Não
	9	Categoria	A		Sim		ITMMASTER	TCLCOD	Categoria	Não
	10	Linha de produto	A		Sim		ITMMASTER	CFGLIN	Linha produto	Não
	11	Gestor :	A		Sim		ITMMASTER	PLANNER	Planificador	Não

(1) O estatuto AZAP tem por valor 1 para os artigos de estatuto activo e 0 nos outros casos.
(2) Os estatutos Artigo são definidos no Menu local 246.

Observações :

O cabeçalho do ficheiro está constituido com os títulos das colunas parametrizados sobre o pivot. Os intitulados não devem ultrapassar 15 caracteres.
Em função da parametrização efectuada, é possível, para cada um dos critérios,de ter o código único, o título único, ou os dois : código e título
Os critérios 4 a 11 podem ser exportados ou não, em função da parametrização efectuada. Quando não são exportados, as colunas não são presentes no ficheiro.

Estabelecimentos : sites.csv

Pivot : SCMAFCY

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Código Host Estabelecimento Cliente ou Estabelecimento para X3	A	15	Não		FACILITY	FCY	Estabelecimento	Não
	2	Título longo	A	35	Sim		FACILITY	FCYNAM	Nome	Não
	3	Título curto	A	10	Sim		FACILITY	FCYSHO	Título curto	Não

Observações :

O cabeçalho do ficheiro está constituido com os códigos colunas parametrizados sobre o pivot.
Os estabelecimentos ao sentido AZAP são dos clientes ou dos depósitos. Todos os clientes e todos os estabelecimento de armazenagem logo exportados via este ficheiro. A diferenciação se fará directamente em AZAP.
Os critérios dos estabelecimentos exportados num ficheiro separado : critstrsite.csv

Estabelecimentos / Critérios : critstrsite.csv

Pivot : SCMACRIFCY

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Código Host Estabelecimento Cliente ou Estabelecimento para X3	A	15	Não		FACILITY	FCY	Estabelecimento	Não
	2	País :	A		Não		BPARTNER	CRY	País :	Não
	3	Categoria)	A		Sim		BPCUSTOMER	BCGCOD	Categoria	Não
	4	Família estatística 1	A		Sim		BPCUSTOMER	WTSCCOD0	Família estat 1	Não
	5	Família estatística 2	A		Sim		BPCUSTOMER	WTSCCOD1	Família estat 2	Não
	6	Família estatística 3	A		Sim		BPCUSTOMER	WTSCCOD2	Família estat 3	Não
	7	Família estatística 4	A		Sim		BPCUSTOMER	WTSCCOD3	Família estat 4	Não
	8	Família estatística 5	A		Sim		BPCUSTOMER	WTSCCOD4	Família estat 5	Não
	9	Cliente facturado	A		Sim		BPCUSTOMER	BPCINV	Cliente facturado	Não
	10	Cliente grupo	A		Sim		BPCUSTOMER	BPCGRU	Cliente grupo	Não

Observações :

O cabeçalho do ficheiro está constituido com os títulos das colunas parametrizados sobre o pivot. Os intitulados não devem ultrapassar 15 caracteres.
Os estabelecimentos ao sentido AZAP são dos clientes ou dos depósitos. Todos os clientes e todos os estabelecimento de armazenagem são logo exportados via este ficheiro. A diferenciação se fará directamente em AZAP.
Em função da parametrização efectuada, é possível, para cada um dos critérios,de ter o código único, o título único, ou os dois :código e título.
Os critérios 2 a 10 podem ser exportados ou não, em função da parametrização efectuada. Quando não são exportados, as colunas não são presentes no ficheiro.

Histórico de vendas : ventes.csv

Pivot : SCMAHSOH

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Data de entrega pedida ou Data de entrega ou período (1)	D		Não		SORDERQ	DEMDLVDAT	Data ent pedida	Não
	2	Código Host Estabelecimento Venda Dador de ordem para X3	A		Não		SORDERQ	BPCORD	Cliente encomenda.	Não
	3	Código Host Produto	A		Não		SORDERQ	ITMREF	Artigo	Não
	4	Quantidade em UV (2)	N		Não		SORDERQ	QTY	Qtd encomendada	Não
	5	Código Host Estabelecimento Origem Estabelecimento expeditor para X3	A		Não		SORDERQ	STOFCY	Estabelecimento expedição	Não

(1) Segundo o nível de agregação escolhido, é a data efectiva ou da data de início de período (semana ou mês) que está considerado para o reagrupamento dos dados.
(2) A quantidade deve estar exprimida em UV : Unidade de venda

Observações :

O cabeçalho do ficheiro está constituido com os códigos colunas parametrizados sobre o pivot.
Se histórico provém das encomendas saldadas, a exportação leva sobre as linhas de encomendas saldadas cuja quantidade foi entregue ou facturada. A parametrização autoriza o registo de uma seleção de encomendas
Se o histórico provém das entregas/faturas, a exportação leva sobre o realizado, quer dizer os fluxos reais :
+ as entregas validadas
+ as faturas diretas validadas com movimento de stock
+ as faturas "encomenda" validadas com o movimento de stock
+ as linhas de factura "entrega" validadas com movimento de stock sem número de entrega
- as devoluções de entrega
- As notas directas validadas com o movimento de stock
- as notas de crédito sobre fatura validadas com movimento de stock
A parametrização autoriza o registo de uma seleção de entregas/faturas.

Em-curso encomendas : carnet.csv

Pivot : SCMASOH

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Data de entrega prevista (1) (2)	D		Não		SORDERQ	EXTDLVDAT	Data entrega prevista.	Não
	2	Código Host Estabelecimento Venda Dador de ordem para X3	A		Não		SORDERQ	BPCORD	Cliente encomenda.	Não
	3	Código Host Produto	A		Não		SORDERQ	ITMREF	Artigo	Não
	4	Quantidade em UV (3) (4)	N		Não		SORDERQ	TDLQTY	Qtd a entregar	Não
	5	Código Host Estabelecimento Origem Estabelecimento expeditor para X3	A		Não		SORDERQ	STOFCY	Estabelecimento expedição	Não

(1) Para as encomendas abertas, trata-se da data de entrega pedida : DEMDLVDAT
(2) Segundo o nível de agregação escolhido, é a data efectiva ou da data de início de período (semana ou mês) que está considerado para o reagrupamento dos dados.
(3) A qunatidade deve ser exprimida em UV : unidade de venda.
(4) Uma encomenda (do livro de contas) não saldado podendo ter já uma qunatidade entregue (tomada em conta no histórico), a quantidade tomada em conta na caderneta está então a quantidade restante a entregar.

Observações :

O cabeçalho do ficheiro está constituido com os códigos colunas parametrizados sobre o pivot.
A exportação leva sobre as linhas de encomendas não saldadas.
A parametrização autoriza o registo de uma seleção de encomendas

Descritivo dos ficheiros importados em Sage X3

Previsões de vendas : previsions.csv

Pivot : SCMASOS

Ficheiro	N°	Título	Tipo	Lg max	Opcional	Pivot :	Código tabela	Código campo	Título	Zona não gerada
	1	Data previsão (1)	D		Não		ORDERS	ENDDAT :	Data fim	Não
	2	Código Host Estabelecimento Origem Estabelecimento expeditor para X3	A		Não		ORDERS	STOFCY	Estabelecimento de armazenagem	Não
	3	Código Host Produto	A		Não		ORDERS	ITMREF	Artigo	Não
	4	Quantidade US (2)	N		Não		ORDERS	EXTQTY	Qtd prevista	Não

(1) Segundo o nível de agregaação escolhida em AZAP, trata-se da data efectiva ou da data de fim de preríodo.
(2) A quantidade deve ser exprimida em US : unidade de stock

Observações :

A importação leva sobre as previsões de venda realizadas em AZAP.
O ficheiro esperado deve ter um cabeçalho.
É possível, por parametrização, de pedir a supressão :
- seja as antigas previsões de cada um dos artigos do ficheiro importado, antes de importar as novas,
- seja de todas as previsões, antes o tratamento do ficheiro.

Mensagens genéricas

Mensagens de erro

Não existe outra mensagem de erro, para além das mensagens genéricas.

Tabelas consideradas

SEEREFERTTO Consulte a docuemntação de Implementação