# Fulfillment Service

Contains functions for verifying fulfillment service requests.

See the [fulfillment service documentation](https://shopify.dev/docs/apps/fulfillment/fulfillment-service-apps) for more information.

```typescript
import {type ActionFunctionArgs} from '@remix-run/node';

import {authenticate} from '../shopify.server';

export const action = async ({request}: ActionFunctionArgs) => {
  const {admin, payload} = await authenticate.fulfillmentService(request);

  const kind = payload.kind;

  if (kind === 'FULFILLMENT_REQUEST') {
    const response = await admin?.graphql(
      `#graphql
         query {
           shop {
             assignedFulfillmentOrders(first: 10, assignmentStatus: FULFILLMENT_REQUESTED) {
               edges {
                 node {
                   id
                   destination {
                   firstName
                   lastName
                 }
                 lineItems(first: 10) {
                   edges {
                     node {
                     id
                     productTitle
                     sku
                     remainingQuantity
                   }
                 }
               }
               merchantRequests(first: 10, kind: FULFILLMENT_REQUEST) {
                 edges {
                   node {
                     message
                   }
                 }
               }
             }
           }
         }
       }
      }`,
    );

    const fulfillments = await response.json();
    console.log(fulfillments);
  }

  return new Response();
};

```

## authenticate.fulfillmentService

Verifies requests coming from Shopify to fulfillment service apps

### AuthenticateFulfillmentService

#### Returns: Promise<FulfillmentServiceContext<ConfigArg, Resources>>

#### Params:

- request: Request
export type AuthenticateFulfillmentService<
  ConfigArg extends AppConfigArg,
  Resources extends ShopifyRestResources = ShopifyRestResources,
> = (
  request: Request,
) => Promise<FulfillmentServiceContext<ConfigArg, Resources>>;


### FulfillmentServiceContext

### admin

value: `AdminApiContext<ConfigArg, Resources>`


An admin context for the fulfillment service request.

Returned only if there is a session for the shop.

### payload

value: `FulfillmentServicePayload`

The payload from the fulfillment service request.

### session

value: `Session`

A session with an offline token for the shop.

Returned only if there is a session for the shop.

## Related

- [Admin API context](https://shopify.dev/docs/api/shopify-app-remix/apis/admin-api)
- [Manage Fulfillments](https://shopify.dev/docs/apps/fulfillment/fulfillment-service-apps/manage-fulfillments)

## Examples

Contains functions for verifying fulfillment service requests.

See the [fulfillment service documentation](https://shopify.dev/docs/apps/fulfillment/fulfillment-service-apps) for more information.


### admin

Use the session associated with this request to use the Admin GraphQL API```typescript
import { ActionFunctionArgs } from "@remix-run/node";
import { authenticate } from "../shopify.server";

export async function action({ request }: ActionFunctionArgs) {
  const { admin, session } = await authenticate.fulfillmentService(request);

  console.log(session.id)

  return new Response();
}
```


### payload

Get the request's POST payload.```typescript
/app/routes/fulfillment_order_notification.ts
import { ActionFunction } from "@remix-run/node";
import { authenticate } from "../shopify.server";

export const action: ActionFunction = async ({ request }) => {
  const { payload } = await authenticate.fulfillmentService(request);
  if(payload.kind === 'FULFILLMENT_REQUEST') {
   // handle fulfillment request
  } else if (payload.kind === 'CANCELLATION_REQUEST') {
   // handle cancellation request
  };
return new Response();
```


### session

Use the session associated with this request.```typescript
import { ActionFunctionArgs } from "@remix-run/node";
import { authenticate } from "../shopify.server";

export const action = async ({ request }: ActionFunctionArgs) => {
  const { session, admin } = await authenticate.fulfillmentService(request);

  console.log(session.id)

  return new Response();
};
```

## Examples

Contains functions for verifying fulfillment service requests.

See the [fulfillment service documentation](https://shopify.dev/docs/apps/fulfillment/fulfillment-service-apps) for more information.


### admin

Use the session associated with this request to use the Admin GraphQL API```typescript
import { ActionFunctionArgs } from "@remix-run/node";
import { authenticate } from "../shopify.server";

export async function action({ request }: ActionFunctionArgs) {
  const { admin, session } = await authenticate.fulfillmentService(request);

  console.log(session.id)

  return new Response();
}
```


### payload

Get the request's POST payload.```typescript
/app/routes/fulfillment_order_notification.ts
import { ActionFunction } from "@remix-run/node";
import { authenticate } from "../shopify.server";

export const action: ActionFunction = async ({ request }) => {
  const { payload } = await authenticate.fulfillmentService(request);
  if(payload.kind === 'FULFILLMENT_REQUEST') {
   // handle fulfillment request
  } else if (payload.kind === 'CANCELLATION_REQUEST') {
   // handle cancellation request
  };
return new Response();
```


### session

Use the session associated with this request.```typescript
import { ActionFunctionArgs } from "@remix-run/node";
import { authenticate } from "../shopify.server";

export const action = async ({ request }: ActionFunctionArgs) => {
  const { session, admin } = await authenticate.fulfillmentService(request);

  console.log(session.id)

  return new Response();
};
```