Install Jentic One Beta

Connect the Fulfillment.com APIv2 to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Fulfillment.com APIv2, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffulfillment.com%2Ffulfillment" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffulfillment.com%2Ffulfillment" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Fulfillment.com APIv2 API.

Submit a new order to the Fulfillment.com warehouse network for pick, pack, and ship

Update an existing order's status or cancel it before dispatch

Track an order through the FDC fulfilment lifecycle using documented status codes

List and update returns processed against the merchant account

Query current and full inventory levels across FDC facilities

GET STARTED

Start building with Fulfillment.com APIv2 API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Fulfillment.com APIv2 API for, with concrete tasks.

★ Direct-to-Consumer Order Submission

When a Shopify or custom storefront takes an order, an integration calls POST /orders on the FDC API with the order line items, ship-to address, and merchant order ID. FDC validates the address, allocates inventory, and returns an FDC order ID. Subsequent calls to GET /orders/{id} return a six-digit status code that maps the order through processing, fulfilment, and shipped.

Create an FDC order with merchantOrderId 'WEB-123', one SKU at quantity 2, and a US ship-to address

Returns Reconciliation

When a customer initiates a return, FDC records it under /returns. A reconciliation script calls GET /returns daily to pull the latest entries and PUT /returns to update merchant-side disposition. This keeps the merchant order management system aligned with what FDC has physically received.

Call GET /returns for the last 7 days and update each return's disposition via PUT /returns

Inventory Visibility

Before allowing checkout on a SKU, the storefront calls GET /inventory to confirm units are available. For low-frequency dashboards, GET /inventory/full pulls the entire merchant inventory snapshot. Combined with order status this gives the merchant a real-time view of stock and fulfilment posture across FDC facilities.

Call GET /inventory for SKU ABC-001 and return current available units

Tracking and Status Updates

Once an order is shipped, GET /track returns carrier tracking metadata and PUT /orders/{id}/ship updates the order to shipped state with departDate. The combination of status codes and tracking lets the merchant power 'where is my order?' surfaces and customer notifications.

Call GET /track for order id 12345 and return the carrier and tracking number

Agent-Driven Fulfilment Operations

An AI agent fields a merchant question like 'what's the status of order WEB-123?' and resolves the FDC order ID, fetches /orders/{id}, /track, and any returns. With Jentic the OAuth2 flow happens behind the scenes - the agent gets a scoped result and never handles the client_secret.

Search Jentic for 'check fulfillment order status', load GET /orders/{id}, and execute against the merchant order ID

Key Endpoints

15 endpoints — fulfillment.

METHOD

PATH

DESCRIPTION

POST

/orders

Submit a new order to FDC

GET

/orders/{id}

Retrieve order status and details

PUT

/orders/{id}/status

Update an order's status

PUT

/orders/{id}/ship

Mark an order as shipped

GET

/track

Retrieve carrier tracking metadata

GET

/inventory

Query current inventory levels

POST

/oauth/access_token

Generate or refresh an OAuth2 access token

POST

/orders

Submit a new order to FDC

GET

/orders/{id}

Retrieve order status and details

PUT

/orders/{id}/status

Update an order's status

PUT

/orders/{id}/ship

Mark an order as shipped

GET

/track

Retrieve carrier tracking metadata

GET

/inventory

Query current inventory levels

POST

/oauth/access_token

Generate or refresh an OAuth2 access token

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring Fulfillment.com by hand means running the OAuth2 password token exchange against /oauth/access_token, also sending an x-api-key header, and refreshing the token yourself against the api.fulfillment.com host. Through Jentic you install once, import Fulfillment.com from the API Directory, store the client credentials and key once, and your agent calls it while Jentic runs the token exchange.

Permission scoping

Fulfillment.com puts the order id in the URL path (/orders/{id}), so you limit the agent to the operations it needs, such as submitting an order or tracking one. You choose which operations it may call, so changing order status or marking it shipped is not included unless you add it.

Credential isolation

Your Fulfillment.com client credentials and API key are stored once, encrypted, by your own Jentic One instance, and the OAuth2 exchange runs at execution time. The secrets and rotated access token never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'submit a fulfillment order' or 'track a fulfillment order', and Jentic returns the matching POST /orders or GET /track operation with its input schema so the agent calls the right endpoint without studying the status-code table in the reference docs.

FAQs

Specific to using Fulfillment.com APIv2 API through Jentic.

What authentication does the Fulfillment.com APIv2 use?

FDC uses OAuth2 bearer tokens generated through POST /oauth/access_token, plus an x-api-key header. Implicit and password grant types are supported and refresh tokens rotate access. Through Jentic the client_id, client_secret, and API key are stored in your Jentic One instance.

Can I submit a new order through the Fulfillment.com API?

Yes. POST /orders with merchantOrderId, line items, and a ship-to address. FDC validates the address, allocates stock, and returns the FDC order id. Use GET /orders/{id} to retrieve the resulting status.

What are the rate limits for the Fulfillment.com API?

FDC does not publish a fixed rate limit but documents that bulk submission should be paced and that idempotency on merchantOrderId protects against duplicates. Treat 5 to 10 calls per second as a polite ceiling and back off on 429 responses.

How do I track an order's shipment through Jentic?

Search Jentic for 'track a fulfillment.com order', load the GET /track schema, and execute with the order id. The response includes carrier and tracking number once FDC has assigned them at the dispatchDate milestone.

What do the six-digit FDC status codes mean?

FDC status codes are formatted as state, stage, and detail (for example 020601 means 'Fulfillment In Progress / Label Printed'). The spec lists every code so that integrations can map status to human-readable messaging without guessing.

Can I cancel an order after it has dispatched?

No. FDC documents that orders cannot be cancelled once they enter dispatch. Use DELETE /orders/{id} only before dispatchDate is set; afterwards a recall must go through the FDC account executive rather than the API.

Can I limit what my agent is allowed to do with the Fulfillment.com API?

Yes. Jentic One is self-hosted by you, so your own rules decide which Fulfillment.com operations and credentials the agent may use. You can allow it to only submit an order (POST /orders) or track one (GET /track) while withholding operations like updating status (PUT /orders/{id}/status) or marking an order shipped (PUT /orders/{id}/ship) unless you explicitly add them. Because the order id lives in the URL path, you scope the agent to exactly the endpoints it needs, and the stored client credentials and API key run the OAuth2 exchange at execution time without entering the agent's context.

Fulfillment.com APIv2

Name: Fulfillment.com APIv2 API
Brand: Fulfillment.com APIv2
Availability: InStock

Official vendor OpenAPI document · agent-readyE CommerceShipping Logisticsoauth2, apiKey15 EndpointsREST

For Agents

Submit and track ecommerce orders through the Fulfillment.com warehouse network, manage returns, and read inventory and accounting data.

Use for: Submit a new order to FDC for shipment, Cancel a Fulfillment.com order before it dispatches, Get the current shipment status of a tracked order, List all returns processed in the last week

Not supported: Does not handle storefronts, payments, or marketing - use for warehouse order submission, tracking, returns, inventory, and accounting only.

Fulfillment.com (FDC) is a 4PL fulfilment provider whose v2 REST API lets merchants submit and track orders, manage returns, query inventory, and reconcile accounting from their warehouse network. The API exposes 15 endpoints covering orders, returns, tracking, inventory, accounting, and a simple OAuth2 access-token flow. Status codes are six digits and are documented in the spec to track an order from received through shipped to returned. Authentication uses OAuth2 bearer tokens and an x-api-key header.

Jentic One on Github View OpenAPI Document

Connect the Fulfillment.com APIv2 to your agent

Capabilities

Start building with Fulfillment.com APIv2 API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Fulfillment.com APIv2