Amazon (Vendor Central & SP-API) + NeutronEDI

import os
import time
import requests

NEUTRON_API_KEY = os.environ["NEUTRON_API_KEY"]
SP_API_BASE = "https://sellingpartnerapi-na.amazon.com"


def list_new_po_documents(access_token: str) -> list[dict]:
    res = requests.get(
        f"{SP_API_BASE}/vendor/orders/v1/purchaseOrders",
        headers={"x-amz-access-token": access_token},
        params={"limit": 50, "isBackOrderRequired": "false"},
        timeout=15,
    )
    res.raise_for_status()
    return res.json()["payload"]["orders"]


def fetch_edi(access_token: str, document_id: str) -> str:
    res = requests.get(
        f"{SP_API_BASE}/documents/2020-09-04/documents/{document_id}",
        headers={"x-amz-access-token": access_token},
        timeout=15,
    )
    res.raise_for_status()
    download_url = res.json()["payload"]["url"]
    return requests.get(download_url, timeout=15).text


def translate(raw_edi: str) -> dict:
    res = requests.post(
        "https://api.neutronedi.com/api/v1/read/x12",
        headers={
            "X-API-Key": NEUTRON_API_KEY,
            "Content-Type": "application/edi-x12",
        },
        data=raw_edi,
        timeout=15,
    )
    res.raise_for_status()
    return res.json()


def push_to_erp(po: dict) -> None:
    # Send the parsed Amazon PO into your ERP — Sales Order create endpoint,
    # Kafka topic, internal queue, etc. Implementation depends on your stack.
    ...


def run(access_token: str) -> None:
    for order in list_new_po_documents(access_token):
        raw_x12 = fetch_edi(access_token, order["ediDocumentId"])
        parsed  = translate(raw_x12)
        for txn in parsed["transactions"]:
            if txn["type"] == "850":
                push_to_erp(txn)
        time.sleep(0.5)  # polite pacing inside SP-API rate limits

{
  "interchange": { "sender": "AMAZON",   "receiver": "VENDOR-ABC", "control": "000001821" },
  "transactions": [
    {
      "type": "850",
      "name": "Purchase Order",
      "poNumber": "1RX29YZ7",
      "date": "2026-04-30",
      "buyerDuns": "0080038559",
      "shipTo": { "name": "Amazon FC PHX5", "city": "Phoenix", "state": "AZ", "zip": "85043" },
      "items": [
        { "sku": "ASIN-B07ABC1234", "qty": 480, "unitPrice": "8.20" },
        { "sku": "ASIN-B07ABC5678", "qty": 240, "unitPrice": "12.40" }
      ],
      "total": "6912.00"
    }
  ]
}