Integre o PDV ao GIRO, no nível Venda da API v1.

Objetivo: a cada venda fechada, avisar o GIRO e imprimir no fim do cupom a imagem que a API devolve.

Contrato (documentação em https://developers.giro.app.br e índice em https://developers.giro.app.br/llms.txt):
1. POST /v1/sales com external_id (chave única da venda no PDV), total_cents, occurred_at (ISO 8601 com fuso) e, se houver, customer.phone em E.164. 
2. Autenticação: cabeçalho Authorization: Bearer com o token da conexão. Guarde o token no cofre do sistema operacional, nunca em arquivo aberto.
3. Envie receipt.format = "image" (padrão e recomendado) e receipt.width (32, 42 ou 48 colunas). Imprima a imagem de receipt.image no fim do cupom (ESC/POS GS v 0). Só se a impressora não imprime imagem, peça receipt.format = "text" com receipt.charset e imprima receipt.lines. Se receipt for null, não imprima nada do GIRO.
4. Idempotência: envie o cabeçalho Idempotency-Key em todo POST e repita a mesma chave quando a rede falhar; external_id identifica a venda. Guarde as vendas sem resposta e reenvie em até 7 dias.
5. Cancelamento: POST /v1/sales/{external_id}/cancel com a mesma chave.
6. A venda nunca trava por causa do GIRO. Em erro, mostre ao operador a frase da coluna "No caixa" do guia Erros e limites, ou registre no log.
7. Antes do pagamento, pergunte o telefone com o texto do guia Experiência no caixa, sempre com a opção "Seguir sem telefone".

Ambiente: use o sandbox (variáveis GIRO_API e GIRO_TOKEN). Se o MCP do desenvolvedor do GIRO estiver conectado, use buscar_documentacao, simular_venda e rodar_conformidade.

Pronto quando: os 13 casos da suíte de conformidade passam no sandbox.