Primeros pasos

Simple API es la API para integrar sistemas de terceros con una empresa en Simple.

URL base

https://api.simple.pe

Las rutas documentadas se agregan directamente a esta URL, sin prefijos /api ni /v2.

Requisitos

• Credenciales activas: API key y API secret de la empresa con la que vas a trabajar.
• IP de salida autorizada, si tu credencial tiene una lista de IP permitidas.
• Una aplicación en tu servidor que conserve el secret de forma privada.

Verificar las credenciales

Configura SIMPLE_API_KEY y SIMPLE_API_SECRET como variables de entorno en tu terminal. Luego ejecuta:

curl --request GET 'https://api.simple.pe/ping' \
  --header 'Accept: application/json' \
  --header "X-Api-Key: ${SIMPLE_API_KEY}" \
  --header "X-Api-Secret: ${SIMPLE_API_SECRET}"

Consulta la respuesta de conexión, las reglas de autenticación y los límites.

Crear una venta

Asigna el scope sales.orders:write a tu credencial desde Configuración → API Keys. La referencia de creación de ventas contiene el cuerpo de la solicitud y su estado actual de disponibilidad. Los IDs y códigos del ejemplo deben corresponder al catálogo de tu empresa.