Introdução + openapi + guia de APIs
http://tdn.totvs.com/display/public/INT/Guia+de+implementacao+das+APIs+TOTVS
Justificar quebra entre dois arquivos distintos. Reusabilidade. Pessoa pode usar o protocolo transactions e se comunicar utilizando apenas schema. Caso outra aplicação necessite, consegue se comunicar através das APIs, seguindo padrão OpenAPI.
API é o contrato, traz informações importantes que definem os moldes das mensagens trafegadas. API Reference mostra as APIs, não os schemas
Schema são as mensagens padronizadas propriamente ditas. Trazem as definições dos types, binda com os produtos totvs através do x-totvs.
Os arquivos que especificam
O API reference tira os dados do json da api. Ir no api reference e identificar se o produto ta la, dentro dos x-totvs
Vincula o arquivo OpenAPI aos produtos TOTVS. Informações necessárias. Mostrar os campos, preenchimento de cada um, etc.
Caso a api já exista mas não para seu produto, significa que você precisa aadaptar a API ao seu produto.
Adicionar novo produto, especificação de adapters etc etc