# AIOTIC Integrator Guide

> Everything an ERP developer, MSP or in-house team needs to integrate AIOTIC purchase-order processing with their business software: the ERP receive endpoint contract, master-data sync patterns, the order lifecycle and API, the Python SDK, and the security model. Verified against AIOTIC API v1.0.0. Documentation revision 3 · Published 8 September 2026 · commit 6862d5e.

AIOTIC reads purchase orders (e-mail attachments, PDFs, scans), extracts them with AI, identifies the customer and article numbers against the master data you sync, lets operators review uncertain cases, and POSTs the reviewed order to your ERP receive endpoint. Product name is "AIOTIC". Base URL per tenant: https://<tenant>.aiotic.ai. Auth: X-API-Key header.

Key facts: the ERP receive endpoint response body field `success` is authoritative (not the HTTP status); `request_id` is stable across retries (idempotency key); statuses: QUEUED, PROCESSING, PROCESSED, ATTENTION, FAILED, RETRY_PENDING, MODIFIED, SENDING, SENT, REPROCESSED, CANCELED; sendable = PROCESSED, MODIFIED, ATTENTION; sync master data on change, never full dumps; no corrections/cancel endpoint exists yet (proposal only).

## Start here

- [What AIOTIC does](https://developers.aiotic.ai/guide/overview.md): Start here
- [Quick start (15 minutes)](https://developers.aiotic.ai/guide/quick-start.md): Start here
- [Integration models](https://developers.aiotic.ai/guide/integration-models.md): Start here
- [Onboarding checklist](https://developers.aiotic.ai/guide/onboarding-checklist.md): Start here
## Concepts

- [Tenants, URLs & environments](https://developers.aiotic.ai/concepts/tenants-and-environments.md): Concepts
- [Authentication & keys](https://developers.aiotic.ai/concepts/authentication.md): Concepts
- [Order lifecycle & statuses](https://developers.aiotic.ai/concepts/order-lifecycle.md): Concepts
- [The purchase-order model](https://developers.aiotic.ai/concepts/purchase-order-model.md): Concepts
- [Reference data](https://developers.aiotic.ai/concepts/reference-data.md): Concepts
- [Errors, idempotency & limits](https://developers.aiotic.ai/concepts/errors-and-idempotency.md): Concepts
## Receiving orders

- [The ERP receive endpoint](https://developers.aiotic.ai/receiving/erp-receive-endpoint.md): Receiving orders
- [Response contract](https://developers.aiotic.ai/receiving/response-contract.md): Receiving orders
- [Idempotency & failure handling](https://developers.aiotic.ai/receiving/idempotency-and-failures.md): Receiving orders
- [Field mapping cookbook](https://developers.aiotic.ai/receiving/field-mapping.md): Receiving orders
- [Validation when your ERP has no functional API](https://developers.aiotic.ai/receiving/validation-layer.md): Receiving orders
- [Testing your endpoint](https://developers.aiotic.ai/receiving/testing.md): Receiving orders
## Keeping data in sync

- [Initial load](https://developers.aiotic.ai/sync/initial-load.md): Keeping data in sync
- [Event-driven sync](https://developers.aiotic.ai/sync/event-driven.md): Keeping data in sync
- [Reconciliation](https://developers.aiotic.ai/sync/reconciliation.md): Keeping data in sync
- [Multi-language products](https://developers.aiotic.ai/sync/multi-language.md): Keeping data in sync
- [Archiving & superseded customers](https://developers.aiotic.ai/sync/archiving.md): Keeping data in sync
## Driving orders via the API

- [Submitting documents](https://developers.aiotic.ai/orders/submitting.md): Driving orders via the API
- [Polling & notifications](https://developers.aiotic.ai/orders/polling.md): Driving orders via the API
- [ATTENTION, FAILED & retries](https://developers.aiotic.ai/orders/attention-and-failures.md): Driving orders via the API
- [Sending to the ERP](https://developers.aiotic.ai/orders/sending.md): Driving orders via the API
- [The processing webhook](https://developers.aiotic.ai/orders/processing-webhook.md): Driving orders via the API
- [Rejected e-mails](https://developers.aiotic.ai/orders/rejected-emails.md): Driving orders via the API
- [Headless limits today](https://developers.aiotic.ai/orders/headless-limits.md): Driving orders via the API
## Python SDK

- [Python SDK — overview & install](https://developers.aiotic.ai/sdk/overview.md): Python SDK
- [Bootstrapping a service](https://developers.aiotic.ai/sdk/bootstrapping.md): Python SDK
- [Client reference](https://developers.aiotic.ai/sdk/client.md): Python SDK
- [Validation & business-rule pipeline](https://developers.aiotic.ai/sdk/pipeline.md): Python SDK
- [ERP adapters (functional vs data API)](https://developers.aiotic.ai/sdk/erp-adapters.md): Python SDK
- [Sync engine](https://developers.aiotic.ai/sdk/sync.md): Python SDK
- [Webhooks & receivers](https://developers.aiotic.ai/sdk/webhooks.md): Python SDK
- [Order watcher](https://developers.aiotic.ai/sdk/watcher.md): Python SDK
- [CLI](https://developers.aiotic.ai/sdk/cli.md): Python SDK
- [Mock AIOTIC server](https://developers.aiotic.ai/sdk/mock-server.md): Python SDK
## API reference

- [API reference](https://developers.aiotic.ai/api/index.md): API reference
- [Health & status](https://developers.aiotic.ai/api/health.md): API reference
- [Orders — intake](https://developers.aiotic.ai/api/orders-intake.md): API reference
- [Orders — status & files](https://developers.aiotic.ai/api/orders-status.md): API reference
- [ERP hand-off](https://developers.aiotic.ai/api/erp.md): API reference
- [Rejected e-mails](https://developers.aiotic.ai/api/rejected.md): API reference
- [Customers](https://developers.aiotic.ai/api/customers.md): API reference
- [Products](https://developers.aiotic.ai/api/products.md): API reference
- [Customer item mappings](https://developers.aiotic.ai/api/customer-products.md): API reference
- [Mailbox](https://developers.aiotic.ai/api/mailbox.md): API reference
- [Outbound: webhooks](https://developers.aiotic.ai/api/webhooks.md): API reference
- [Schemas](https://developers.aiotic.ai/api/schemas.md): API reference
## Security & operations

- [Security checklist](https://developers.aiotic.ai/security/checklist.md): Security & operations
- [Data, privacy & retention](https://developers.aiotic.ai/security/data-and-privacy.md): Security & operations
- [Monitoring](https://developers.aiotic.ai/security/monitoring.md): Security & operations
## AI-assisted integration

- [LLM-native docs (llms.txt)](https://developers.aiotic.ai/ai/llms-txt.md): AI-assisted integration
- [AIOTIC MCP server](https://developers.aiotic.ai/ai/mcp-server.md): AI-assisted integration
## Appendix

- [Proposal: headless API additions](https://developers.aiotic.ai/appendix/proposal-headless-api.md): Appendix
- [Status reference](https://developers.aiotic.ai/appendix/status-reference.md): Appendix
- [Glossary](https://developers.aiotic.ai/appendix/glossary.md): Appendix
- [FAQ](https://developers.aiotic.ai/appendix/faq.md): Appendix
- [Changelog](https://developers.aiotic.ai/appendix/changelog.md): Appendix

## Machine-readable

- [OpenAPI 3.1 document](https://developers.aiotic.ai/openapi.yaml): all public endpoints plus the outbound webhooks (ERP receive endpoint, processing webhook)
- [Full guide as one file](https://developers.aiotic.ai/llms-full.txt)
- [ERP receive request sample](https://developers.aiotic.ai/samples/erp-receive-sample.json)
- [Order status sample](https://developers.aiotic.ai/samples/order-status-sample.json)

## Optional

- [MCP server](https://developers.aiotic.ai/ai/mcp-server.md): tools to search this guide and read endpoint contracts from an AI assistant
- [Python SDK on PyPI](https://pypi.org/project/aiotic-sdk/): `pip install "aiotic-sdk[all]"`