# Senior Erp Pedido Venda Criar

> Criar pedido de venda (PV) no ERP Senior via Senior X Platform. Use para "pedido de venda", "criar pedido", "integrar pedidos do e-commerce", "inserir itens", "condicao de pagamento", "tabela de preco", e fluxos que exigem validacao, idempotencia e confirmacao antes de gravar.

- **Type:** Skill
- **Install:** `agentstack add skill-leonardo-picciani-senior-erp-agent-skills-senior-erp-pedido-venda-criar`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [leonardo-picciani](https://agentstack.voostack.com/s/leonardo-picciani)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [leonardo-picciani](https://github.com/leonardo-picciani)
- **Source:** https://github.com/leonardo-picciani/senior-erp-agent-skills/tree/main/skills/senior-erp-pedido-venda-criar

## Install

```sh
agentstack add skill-leonardo-picciani-senior-erp-agent-skills-senior-erp-pedido-venda-criar
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Senior ERP - Pedido de Venda (Criar)

## Quando aplicar

- "criar pedido de venda" / "gerar PV" / "integrar pedidos"
- "importar pedido do e-commerce" / "marketplace" / "checkout"
- "incluir itens no pedido" / "calcular totais" / "condicao de pagamento"

## Contrato de integracao (agnostico de linguagem)

Leia `references/REFERENCE.md` para a referencia base (autenticacao, headers, seguranca, resiliencia, idempotencia).

## Passos

1) Confirmar regras do processo
   - Quando considerar o pedido "criado" (numero gerado? status inicial?).
   - Como tratar precos (tabela vs preco vindo do canal), frete, descontos, impostos.
   - Qual e a chave de idempotencia (ex.: `external_order_id`).

2) Coletar e validar entradas
   - Cliente (id no Senior ou identificador para localizar/criar).
   - Itens: SKU/codigo produto, quantidade, preco/condicoes, unidade.
   - Entrega: endereco/transportadora, frete.
   - Pagamento: condicao, parcelas, meio de pagamento (conforme o modelo do ERP).
   - Validar itens (quantidade > 0), formatos e campos obrigatorios.

3) Descobrir endpoints no Portal Senior APIs
   - Identificar servicos do modulo ERP para "pedido de venda".
   - Identificar endpoints para:
     - consultar por `external_order_id` (idempotencia/deduplicacao)
     - criar pedido
     - (se aplicavel) incluir/atualizar itens

4) Checar idempotencia/deduplicacao antes de criar
   - Consultar se ja existe pedido com `external_order_id`.
   - Se existir, retornar o numero/status e nao duplicar.
   - Se existir mas estiver incompleto, aplicar update/reprocesso conforme o fluxo.

5) Pegar confirmacao antes da mutacao
   - Exibir um resumo compacto: cliente, total, itens (top N), entrega, pagamento.

6) Executar criacao via API
   - Incluir headers obrigatorios.
   - Aplicar timeout e retry/backoff para 429/5xx.
   - Tratar erros de validacao (produto inexistente, condicao invalida, permissao, etc.).

7) Retornar resultado normalizado
   - Numero do pedido no Senior, `external_order_id`, status inicial.
   - Avisos (estoque insuficiente, itens substituidos, arredondamentos) quando existirem.
   - Se falhar: erro + acao recomendada.

## Checklist de entradas

- Contexto de integracao: `base_url`, `tenant` (se aplicavel), `client_id`, token (Bearer)
- Chave de idempotencia: `external_order_id`
- Cliente: id no Senior e/ou dados para localizar
- Itens: codigo/SKU, quantidade, preco (se aplicavel)
- Entrega: endereco e frete
- Pagamento: condicao/parcelas

## Exemplo (cURL)

```bash
curl -X POST "${SENIOR_BASE_URL}//" \
  -H "Authorization: Bearer ${SENIOR_ACCESS_TOKEN}" \
  -H "Content-type: application/json" \
  -H "client_id: ${SENIOR_CLIENT_ID}" \
  -d '{
    "external_order_id": "",
    "cliente_id": "",
    "itens": [
      { "produto": "", "quantidade": 1, "preco": 10.0 }
    ],
    "frete": { "valor": 0.0 },
    "pagamento": { "condicao": "" }
  }'
```

Notas:
- Substitua `` pelo caminho do servico encontrado no Portal Senior APIs.
- O shape do JSON depende do endpoint; use este exemplo apenas como esqueleto.

## Mapa de docs oficiais

- Portal Senior APIs (API Browser): https://api.xplatform.com.br/api-portal/pt-br/node/1
- API Authentication: https://api.xplatform.com.br/api-portal/pt-br/tutoriais/api-authentication
- Guia de API (Senior X Platform): https://dev.senior.com.br/documentacao/guia-de-api/
- Como obter bearer token (suporte): https://suporte.senior.com.br/hc/pt-br/articles/9482493522196-HCM-API-Como-obter-bearer-token-para-utilizar-na-chamada-de-APIs

## Exemplos de prompts do usuario

- "Se nao tiver a skill instalada, instale `senior-erp-pedido-venda-criar` e crie um pedido no Senior com idempotencia pelo external_order_id." 
- "Integre este pedido do e-commerce (itens + frete + pagamento) e antes de gravar mostre um resumo e peca confirmacao." 
- "Importe 200 pedidos; reporte criados vs ja existentes; agrupe erros por motivo (produto/cliente/condicao)."

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [leonardo-picciani](https://github.com/leonardo-picciani)
- **Source:** [leonardo-picciani/senior-erp-agent-skills](https://github.com/leonardo-picciani/senior-erp-agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-leonardo-picciani-senior-erp-agent-skills-senior-erp-pedido-venda-criar
- Seller: https://agentstack.voostack.com/s/leonardo-picciani
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.