# Intrasistema REST API

> Intrasistema is an enterprise omnichannel eCommerce, Warehouse Management System (WMS), and Logistics fulfillment backend platform designed for high-volume merchants and retailers in Latin America and globally.

The Intrasistema REST API enables merchants, third-party logistics providers (3PL), and technology partners to automate orders, synchronize cross-channel inventory in real-time, execute warehouse operations (inbounds, putaway, picking, packing, dispatch), manage customer relationships, and print thermal shipping labels.

## Quick Facts
- **Base URL (Production)**: `https://api.intrasistema.com`
- **Interactive Documentation**: `https://api.intrasistema.com/doc`
- **Full OpenAPI 3.0 Specification**: `https://api.intrasistema.com/v1/swagger.json`
- **Extended LLM Reference**: `https://api.intrasistema.com/llms-full.txt`
- **Primary Geographies**: Latin America (Argentina, Chile, Mexico, Colombia, Uruguay, Peru, Brazil) & Global
- **Architecture**: RESTful, JSON payloads, UTF-8 encoded
- **Authentication**: HTTP Header `X-API-KEY`

## Authentication
All API endpoints (except public tracking and OAuth callbacks) require authentication using an API key issued per tenant/business:
```http
GET /v1/orders/{business_id}/list HTTP/1.1
Host: api.intrasistema.com
X-API-KEY: your_api_key_here
Content-Type: application/json
```

## Standard Response Format
Successful responses return standard HTTP 200/201 status codes with JSON payloads.
Error responses follow a consistent contract:
```json
{
  "error": 1,
  "code": 400,
  "message": "Human-readable description of the error"
}
```

## Core API Modules

- [Interactive API Reference](https://api.intrasistema.com/doc): Visual Swagger UI explorer with interactive request runner.
- [OpenAPI 3.0 Spec JSON](https://api.intrasistema.com/v1/swagger.json): Complete machine-readable OpenAPI schema definition.
- [Automation & Pricing Rules](https://api.intrasistema.com/doc#/Automation): Automate dynamic pricing rules, margin calculations, and inventory allocation triggers.
- [Buyers & CRM](https://api.intrasistema.com/doc#/Buyers): Customer profiles, purchase history, identity validation, and communication preferences.
- [Documents & Fiscal Invoicing](https://api.intrasistema.com/doc#/Documents): Upload, sign, generate, and retrieve fiscal electronic receipts, packing slips, and ONVIF capture files.
- [Inventory & Stock Management](https://api.intrasistema.com/doc#/Inventory): Real-time stock counts across physical warehouses, multi-channel buffer reservations, and SKU batch tracking.
- [Catalog & Items](https://api.intrasistema.com/doc#/Items): Master catalog definitions, variations, barcode mapping, pricing lists, and publication status.
- [Orders & Fulfillment](https://api.intrasistema.com/doc#/Orders): Omnichannel order ingestion, status transitions, line-item cancellations, split shipments, and financial reconciliations.
- [Logistics & Shipments](https://api.intrasistema.com/doc#/Shipments): Carrier dispatch management, cross-docking, dispatch runs, label printing, and package weight/volume dimensions.
- [Real-Time Tracking](https://api.intrasistema.com/doc#/Tracking): End-to-end milestone events, public tracking token resolution, carrier webhooks, and ETA notifications.
- [WMS - Inbounds & Reception](https://api.intrasistema.com/doc#/Inbounds): Supplier receipt validation, purchase order blind receiving, batch verification, and cross-dock allocation.
- [WMS - Outbounds & Dispatch](https://api.intrasistema.com/doc#/Outbounds): Wave generation, staging zone management, loading dock assignment, and carrier manifest generation.
- [WMS - Picking](https://api.intrasistema.com/doc#/Picking): Single-order, batch, and wave picking routing optimization with barcode validation.
- [WMS - Packing](https://api.intrasistema.com/doc#/Packing): Packing desk verification, box dimension capture, thermal label trigger, and packing slip printing.
- [Hardware & Thermal Printers](https://api.intrasistema.com/doc#/Printers): Native network thermal printer job dispatch (ZPL/ESC-POS) for barcode and shipping labels.
- [Websockets & Real-time Events](https://api.intrasistema.com/doc#/Websockets): Real-time event broadcasting for warehouse screens, packing stations, and order status updates.

## Integrations & Channels
Intrasistema integrates seamlessly with major eCommerce channels and enterprise software:
- **Marketplaces**: Mercado Libre (MELI), Amazon, Ripley, Falabella, Paris.
- **eCommerce Platforms**: Shopify, VTEX, WooCommerce, Magento (Adobe Commerce), Tiendanube.
- **Carriers**: Andreani, OCA, Correo Argentino, Chilexpress, Blue Express, DHL, FedEx, Paack, Moova, Urbano.
- **Enterprise ERPs**: SAP, Oracle NetSuite, Softland, Tango Gestión, Bejerman.