...
- Type: Indica o tipo do campo, mais detalhes consultar o tópico Tipos de dados padrão.
- Description: é importante que a descrição esteja bem detalhada, lembre-se que para o analista que está propondo um campo, o objetivo deste campo é sempre muito óbvio, porém próximos analistas do mesmo produto ou até analistas de outros produtos sempre terão dificuldade caso o campo não esteja bem documentado.
- x-totvs: propriedade customizada com a documentação referente ao campo em cada produto Totvs.
...
Exemplo reais e proposta de correção |
---|
TableCodeItem - Código da Tabela de Preços (Deveria ser PriceListCode ou PriceTableCode) SalesPrice - Preço de mínimo de venda do produto (Deveria ser MinimumSalesPrice) |
Tipos dados padrõesOs Tipo de dados seguem as especificações do OpenAPI 3.0.1.
...