# AP2: o mandato de compra e o estado da negociação no jsonW O AP2 registra o que a pessoa autorizou o agente a comprar. Na Wortic, o limite, o prazo e a validade do mandato entram numa negociação guardada em jsonW. Veja o que o protocolo prevê, quais campos a casa usa e o que ainda não está no ar. 15 de novembro de 2026 · jsonW 1.3.11 · https://jsonw.org/newsroom/ap2-mandato-e-negociacao-em-jsonw ## O protocolo O AP2 é um protocolo para pagamentos feitos por agentes. O seu centro é o mandato, um documento assinado pela pessoa. O mandato diz o que o agente pode comprar, até qual valor, em qual prazo e até quando vale. O protocolo separa o consentimento do pagamento. O pagamento segue pelo meio que a loja usa. ## O mandato como dado Na prática, o mandato é um conjunto de campos. A Wortic usa um resumo dele dentro da negociação entre agentes. O resumo traz quatro informações: o preço limite, o prazo limite em dias, a quantidade e a data até a qual o mandato vale. O código de entrada confere esses campos. O preço é lido como texto com duas casas decimais, como "1100.00". Assim, o sistema nunca interpreta um número com vírgula. Um mandato sem data futura é recusado. ## Onde o estado fica A negociação guarda o seu estado em jsonW vivo. Isso quer dizer que cada proposta, aceite ou recusa entra como uma atualização do registro. As duas partes leem a mesma proposta vigente. Quem consulta só vê o que é da sua própria parte da negociação. ``` // o estado da negociação: quem propôs, o que foi proposto e o que está vigente``` O registro é o do acordo em andamento. Ele não substitui o pedido. Quando o comprador aceita dentro do teto do mandato dele, o acordo vira pedido pelas funções do banco de checkout. ## Teto e limite O preço máximo que o comprador aceita vem do mandato dele, e não do vendedor. Essa regra evita que um vendedor empurre um valor acima do autorizado. O teto que vale é sempre o do mandato do comprador. ## O que não está no ar O comprador autônomo ainda não está no ar. A verificação do mandato está no hub da casa, mas um agente comprador completo ainda está em preparação. ## Como conferir o registro Para auditar um acordo, leia o estado de cada parte e o mandato gravado. Compare o preço final com o teto. Se o acordo passou do teto, há um erro no fluxo, e não uma condição de negócio. ## Por que vale guardar o mandato junto Se a compra for contestada, a empresa precisa mostrar quem autorizou e até quanto. Guardar o mandato junto da negociação evita a busca em dois lugares. A resposta sai de um registro só. O repositório oficial do protocolo está em github.com/google-agentic-commerce/AP2. ## Campos que a casa confere Um mandato no registro traz o teto, o prazo, a quantidade e a validade. Cada campo é conferido na entrada. Um valor fora do formato, como um preço com vírgula, é recusado antes de virar registro. Assim, o estado não recebe um número que o sistema não consegue comparar. O jsonW exige que o esquema esteja declarado no cabeçalho do arquivo. Quem lê o arquivo sabe o significado de cada coluna sem adivinhar. Fonte: https://github.com/google-agentic-commerce/AP2