Function

Functions is the secret sauce of Ollie Shop. Is where the magic happens.

All Functions run server-side guaranteeing security and maximum performance.

Use functions to run the business logic of the customization. Make requests to external systems, transform payloads, go crazy.

​

Execution Timing

Configure when your function runs:

• Request: Execute before sending data to your e-commerce platform

  • Example: Validate cart quantity limits before adding items

• Response: Execute after the platform processes the request

  • Example: Hide payment methods based on new cart total

​

Error Handling

Configure how your function responds to errors:

• Throw: Abort the operation and return a 4xx error to the user
• Skip: Continue processing without raising errors

Use the Ollie SDK’s Reject function to return structured error responses:

import { reject } from "@ollieshop/sdk";

// Return a 422 error with custom message
return reject("Maximum quantity exceeded for this product");

​

Function Requirements

Functions follow the same structure as Components:

​

Required Files

1. TypeScript file - Your function logic
2. package.json - Dependencies and metadata
3. node_modules/ - Installed dependencies

​

Basic Function Structure

  export const handler = ({ req, res }: { req: Request; res: Response }) => {
      if (req.url.startsWith('https://jsonplaceholder.typicode.com/users')) {
          return Response.json({
              message: 'Not authorized'
          }, {
              status: 401
          })
      }

      if (req.url.startsWith('https://jsonplaceholder.typicode.com/posts/2')) {
          return new Request('https://jsonplaceholder.typicode.com/posts/1', {
              ...req,
              body: null,
          })
      }

      return
  }

​

Deployment

Deploy functions using the Ollie Builder API:

1. Compress your function folder as a ZIP file
2. Use the API with your function ID
3. Associate with the appropriate Version