Billbee API

{
  "service_type": "platform",
  "base_url": "https://api.billbee.io/api/v1",
  "auth_method": "api_key",
  "auth_config": {
    "header_name": "X-Billbee-Api-Key",
    "header_value": "YOUR_API_KEY",
    "additional_headers": {
      "User-Agent": "YourAppName/Version (contact@yourdomain.com)"
    }
    "notes": "API key is per-user generated in Billbee account settings. Optionally supports Basic Auth with email as username and API key as password, but header method is standard. Must include a descriptive User-Agent header."
  },
  "endpoints": [
    {
      "path": "/customers",
      "method": "GET",
      "purpose": "Retrieve a list of customers",
      "params": {
        "page": "integer, pagination page",
        "pageSize": "integer, default 50, max 250",
        "search": "string, search term"
      }
    },
    {
      "path": "/customers/{id}",
      "method": "GET",
      "purpose": "Get a single customer by ID"
    },
    {
      "path": "/customers/{id}",
      "method": "PUT",
      "purpose": "Update a customer"
    },
    {
      "path": "/orders",
      "method": "GET",
      "purpose": "Retrieve a list of orders",
      "params": {
        "page": "integer",
        "pageSize": "integer, default 50, max 250",
        "orderDateFrom": "ISO8601",
        "orderDateTo": "ISO8601",
        "state": "integer: 0=Unknown,1=Incomplete,2=Open,3=InProcess,4=Completed,5=Cancelled"
      }
    },
    {
      "path": "/orders/{id}",
      "method": "GET",
      "purpose": "Get a single order by ID"
    },
    {
      "path": "/orders/{id}",
      "method": "PUT",
      "purpose": "Update an order"
    },
    {
      "path": "/orders/{id}/deliver",
      "method": "POST",
      "purpose": "Mark order as delivered, creates shipping"
    },
    {
      "path": "/orders/{id}/invoice",
      "method": "POST",
      "purpose": "Create an invoice for an order"
    },
    {
      "path": "/products",
      "method": "GET",
      "purpose": "Retrieve a list of products",
      "params": {
        "page": "integer",
        "pageSize": "integer, default 50, max 250",
        "modifiedAfter": "ISO8601"
      }
    },
    {
      "path": "/products/{id}",
      "method": "GET",
      "purpose": "Get a single product"
    },
    {
      "path": "/products/{id}",
      "method": "POST",
      "purpose": "Update a product (partial update)"
    },
    {
      "path": "/products",
      "method": "POST",
      "purpose": "Create a new product"
    },
    {
      "path": "/shipping",
      "method": "GET",
      "purpose": "Retrieve shipping methods"
    },
    {
      "path": "/shipping",
      "method": "POST",
      "purpose": "Create a shipping (or update, legacy)"
    },
    {
      "path": "/shipping/{id}",
      "method": "GET",
      "purpose": "Get a shipping by ID"
    },
    {
      "path": "/invoices",
      "method": "GET",
      "purpose": "Retrieve invoices",
      "params": {
        "page": "integer",
        "pageSize": "integer",
        "invoiceDateFrom": "ISO8601",
        "invoiceDateTo": "ISO8601",
        "customerId": "integer"
      }
    },
    {
      "path": "/invoices/{id}",
      "method": "GET",
      "purpose": "Get a single invoice"
    },
    {
      "path": "/shops/new",
      "method": "GET",
      "purpose": "Get new keys for ShopAccounts (deprecated?)"
    },
    {
      "path": "/shopaccounts",
      "method": "GET",
      "purpose": "List shop accounts (supported since v1, recent addition)"
    },
    {
      "path": "/automaticdeliverydeliveries",
      "method": "GET",
      "purpose": "Get automatic delivery deliveries"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "billbee_itself": "SaaS with free plan for small volume, paid plans based on order volume",
      "api_access": "Included in all plans including free tier, rate limits vary by plan"
    }
  },
  "rate_limits": {
    "general": "No explicit public rate limit documented, but heavy requests are throttled; use pagination and API key with user-agent. Advised to avoid parallel requests and to implement backoff."
  },
  "capabilities": [
    "Order management (retrieve, update, dispatch)",
    "Customer management (retrieve, update, search)",
    "Product management (create, read, update)",
    "Shipping creation and shipment tracking",
    "Invoice generation and retrieval",
    "Multi-channel order aggregation",
    "Integration with marketplaces (eBay, Amazon, etc.)",
    "ERP-like workflows for e-commerce",
    "Pricing, stock sync",
    "Per-user API key authentication",
    "OpenAPI 3.0 specification available"
  ],
  "raw_analysis": "Billbee is a German-based SaaS platform for e-commerce order management, logistics, and accounting. It centralizes orders from various sales channels (marketplaces, web shops) and synchronizes stock and customer data. The API allows external applications to automate order processing, product data management, shipping creation, and invoice handling. The

2/3 tests passed

```json
{
  "overall": 36,
  "dimensions": {
    "token_efficiency": 4.0,
    "first_try_success": 3.0,
    "response_parseability": 3.0,
    "error_clarity": 2.0,
    "doc_quality": 4.0,
    "auth_simplicity": 5.0,
    "latency": 9.0,
    "consistency": 6.0
  },
  "pricing_normalized": {
    "model": "unknown",
    "notes": "No pricing information captured; appears to be a German e-commerce software platform"
  },
  "issues": [
    "No llms.txt file found (404) - agent cannot discover API/feature documentation programmatically",
    "Website is in German (lang=de-DE) which may complicate parsing for English-focused agents",
    "No structured API or capability information provided in the analysis results",
    "Null capabilities and empty pricing model extracted from platform crawl",
    "No clear indication of an API endpoint or export mechanism for automated workflows",
    "Website appears to be a general marketing page with no developer-first content visible",
    "Error clarity cannot be assessed due to lack of documentation on limitations",
    "Pricing model completely unknown - problematic for agent recommendations"
  ],
  "recommendations": [
    "Add a llms.txt file to expose API endpoints, feature documentation, and pricing in a parsable format",
    "Provide English version of core documentation for broader agent accessibility",
    "Publish clear API documentation with structured schemas for orders, products, and shipments",
    "Add a public status page with uptime metrics and system health details",
    "Clearly document authentication flows (API keys vs OAuth) with example requests",
    "Expose pricing tiers and rate limits in machine-readable format (JSON)",
    "Add structured product capabilities page for agents to quickly understand feature set"
  ]
}
```