A integração permite atribuir um valor a campos adicionais em casos de ASMS (a atribuição do valor depende do tipo de campo).
Na propriedade de “additionalFields” o arquivo de configuração mapeará os campos adicionais que compõem os casos do ASMS.
O arquivo de configuração tem a seguinte estrutura:
{
"additionalFields": [
{
"fieldId": 0,
"values": [
""
]
}
]
}
Onde:
- fieldId: ID do campo adicional.
- Valores: Representa o valor que o campo adicional terá, esse valor depende do tipo de campo e sempre será escrito como uma “string”.
Ver campos adicionais
Você pode consultar os campos adicionais usando a API:
API Campos adicionales
api/v9/item/additionalfields
Faça um pedido com o verbo POSTAGEM HTTP com o seguinte JSON
{
"categoryId": 0,
"consoleType": "specialist",
"itemType": 0,
"modelId": 0,
"stateId": 0
}
Para obter mais informações, consulte a documentação do ASMS
Atribuir valores
O ASMS tem os seguintes tipos de campos adicionais:
- Texto curto (ShortText)
- Data e hora (data e hora)
- Lista (Lista)
- Parágrafo (Texto Longo)
- Verdadeiro ou Falso (CheckBox)
- Inteiro (Numérico)
- Árvore (recursiva)
- Decimal (Decimal)
- Arquivo [N/A]
- Catálogo (Lista) (CatalogList)
- Catálogo (Árvore) (CatalogTree)
- Data (Data)
- Tempo (Tempo)
- Moeda (Moeda)
- Link (Link)
- Posição [N/A]
- Seleção múltipla (MultiSelect)
Para atribuir um valor, cada campo deve ter o seguinte formato:
-
Texto curto (ShortText):
Digite o texto sem qualquer restrição, entre aspas “”.
Exemplo:
"values":[
"Prueba"
]
-
Data e hora (data e hora)
Insira a data no seguinte formato ISO 8601.
Exemplo:
"values":[
"2022-01-01T24:12:03"
]
-
Lista (Lista)
Coloque o valor da lista conforme encontrado no ASMS:
Ou, na falta disso, o Id desse valor entre aspas, por exemplo, “valor 2” ou “4” (ID do valor).
Exemplo:
Nombre
"values":[
"valor 2"
]
Id
"values":[
"4"
]
-
Parágrafo (Texto Longo)
Digite o texto sem qualquer restrição, entre aspas “”.
Exemplo:
"values":[
"Prueba"
]
-
Verdadeiro ou Falso (CheckBox)
Insira o seguinte valor: “Verdadeiro” ou “Falso”, conforme apropriado.
Exemplo:
"values":[
"True"
]
-
Inteiro (Numérico)
Digite um número inteiro que corresponda entre aspas. Exemplo “0000”.
Exemplo:
"values":[
"0000"
]
-
Árvore (recursiva)
O valor do campo deve ser formatado da seguinte maneira:
Exemplo:
"values":[
"valor 1\valor 2\valor 3"
]
Veja o exemplo a seguir
Para o exemplo, o valor seria o seguinte:
Exemplo:
"values":[
"nodo 1\nodo hijo 1\nodo terciario 2"
]
-
Decimal (Decimal)
Insira um número decimal correspondente entre aspas. Exemplo “00.00”
Exemplo:
"values":[
"00.00"
]
-
Catálogo (Lista) (CatalogList)
Digite o valor da lista conforme encontrado no ASMS:
Ou, na falta disso, o Id desse valor, por exemplo, “Santa Marta” ou “113” (id do valor).
Exemplo:
Nombre
"values":[
"Santa Marta"
]
Id
"values":[
"113"
]
-
Catálogo (Árvore) (CatalogTree)
O valor do campo deve ser formatado da seguinte maneira:
Exemplo:
"values":[
"valor 1\valor 2\valor 3"
]
Veja o seguinte exemplo:
Para o exemplo, o valor seria o seguinte:
Exemplo:
"values":[
"Colombia\Nariño\Pasto"
]
-
Data (Data)
Insira a data no seguinte formato ISO 8601.
Exemplo:
"values":[
"2022-01-01 00:00:00"
]
-
Tempo (Tempo)
Insira a hora no seguinte formato:
HH:mm:ss
Exemplo:
"values":[
"23:30:12"
]
-
Moeda (Moeda)
Insira um número decimal correspondente entre aspas.
Exemplo:
"values":[
"12.8"
]
-
Link (Link)
Digite o valor que corresponde a uma URL entre aspas.
Exemplo:
"values":[
"https://www.ejemplo.net/"
]
-
Seleção múltipla (MultiSelect)
Para o tipo “MultiSelect”, o “valores”, essa propriedade é do tipo array, onde conterá o nome ou IDs como “string” que correspondem ao campo, por exemplo:
Exemplo:
Nombre
"values":[
"select 1",
"select 2",
"select 3"
]
Id
"values":[
"1",
"2",
"3"
]