Getting started:

In order to make a request you will need to include an authentication token in the request header. This token can be found in the integrations > developers tab section from your recipok account.

Base URL: https://api.recipok.com/api

Ingredients

Gets a list of existing resources.

Parameters

No parameters

Pagination

This endpoint supports pagination, Ex: api.recipok.com/api/final-path?page=1&limit=20

  • page: page number
  • limit: number of items per page

Response – Successful operation

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "items": [
      {
        "id": "numeric",
        "name": "string",
        "priceUnit": "numeric, possible values 0=KG, 1=LT, 2=UD",
        "price": "numeric",
        "format": "numeric",
        "sku": "string",
        "pva": "numeric",
        "brand": "string",
        "measurementUnit": "numeric, possible values 0=gr, 1=ml, 2=pz",
        "allergens": "array",
        "displayName": "string",
        "energeticValue": "numeric",
        "fats": "numeric",
        "saturatedFats": "numeric",
        "monounsaturatedFats": "numeric",
        "polyunsaturatedFats": "numeric",
        "carbohydrates": "numeric",
        "cholesterol": "numeric",
        "transFats": "numeric",
        "omegaFats": "numeric",
        "sugars": "numeric",
        "protein": "numeric",
        "weight": "numeric",
        "salt": "numeric",
        "decrease": "numeric",
        "link": "string",
        "linkText": "string",
        "advertise": "numeric",
        "barcodeNumber": "string",
        "calculatedPrice": "numeric",
        "calculatedPriceFormat": "numeric",
        "supplier": "string",
        "family": "string"
      }
    ],
    "pagination": {
      "currentPage": "numeric",
      "totalPages": "numeric",
      "totalItems": "numeric",
      "itemsPerPage": "numeric"
    }
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Obtains a specific resource using an identifier.

Parameters

id: Resource identifier.

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "item": [
      {
        "id": "numeric",
        "name": "string",
        "priceUnit": "numeric, possible values 0=KG, 1=LT, 2=UD",
        "price": "numeric",
        "format": "numeric",
        "sku": "string",
        "pva": "numeric",
        "brand": "string",
        "measurementUnit": "numeric, possible values 0=gr, 1=ml, 2=pz",
        "allergens": "array",
        "displayName": "string",
        "energeticValue": "numeric",
        "fats": "numeric",
        "saturatedFats": "numeric",
        "monounsaturatedFats": "numeric",
        "polyunsaturatedFats": "numeric",
        "carbohydrates": "numeric",
        "cholesterol": "numeric",
        "transFats": "numeric",
        "omegaFats": "numeric",
        "sugars": "numeric",
        "protein": "numeric",
        "weight": "numeric",
        "salt": "numeric",
        "decrease": "numeric",
        "link": "string",
        "linkText": "string",
        "advertise": "numeric",
        "barcodeNumber": "string",
        "calculatedPrice": "numeric",
        "calculatedPriceFormat": "numeric",
        "supplier": "string",
        "family": "string"
      }
    ]
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Create a resource.

Parameters

No parameters

Request body

The new Ingredients resource

				
					{
  "name": "string",
  "measurementUnit": "string",
  "format": "numeric",
  "price": "numeric"
}
				
			

Response

				
					{
  "status": "success",
  "code": 201,
  "message": "Successful operation",
  "data": {
    "item": {
      "id": "numeric"
    }
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Raw Material Movevemts

Gets a list of existing resources.

Parameters

No parameters

Pagination

This endpoint supports pagination, Ex: api.recipok.com/api/final-path?page=1&limit=20

  • page: page number
  • limit: number of items per page

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "items": [
      {
        "supplierId": "numeric",
        "date": "string",
        "identification": "string",
        "products": [
          {
            "id": "numeric",
            "measurementUnit": "numeric",
            "totalAmount": "numeric",
            "price/ud": "numeric",
            "numLot": "string"
          }
        ]
      }
    ],
    "pagination": {
      "currentPage": "numeric",
      "totalPages": "numeric",
      "totalItems": "numeric",
      "itemsPerPage": "numeric"
    }
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Obtains a specific resource using an identifier.

Parameters

id: Resource identifier.

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "item": {
      "supplierId": "numeric",
      "date": "string",
      "identification": "string",
      "products": [
        {
          "id": "numeric",
          "measurementUnit": "numeric",
          "totalAmount": "numeric",
          "price/ud": "numeric",
          "numLot": "string"
        }
      ]
    }
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Create a resource.

Parameters

No parameters

Request body

The new Ingredients resource

				
					{
  "supplierId": "numeric",
  "createdAt": "string",
  "identification": "string"
}
				
			

Response

				
					{
  "status": "success",
  "code": 201,
  "message": "Successful operation",
  "data": {
    "item": {
      "id": "numeric"
    }
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Finished Product Movevemts

Gets a list of existing resources.

Parameters

No parameters

Pagination

This endpoint supports pagination, Ex: api.recipok.com/api/final-path?page=1&limit=20

  • page: page number
  • limit: number of items per page

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "items": [
      {
        "id": "numeric",
        "customer": "string",
        "createdAt": "string",
        "deliverDate": "string",
        "documentNumber": "string",
        "status": "numeric"
      }
    ],
    "pagination": {
      "currentPage": "numeric",
      "totalPages": "numeric",
      "totalItems": "numeric",
      "itemsPerPage": "numeric"
    }
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Obtains a specific resource using an identifier.

Parameters

id: Resource identifier.

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "item": [
      {
        "customer": "string",
        "createdAt": "string",
        "deliverDate": "string",
        "documentNumber": "string",
        "total": "string",
        "weight": "string",
        "status": "numeric"
      }
    ]
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Finished Product Orders

Gets a list of existing resources.

Parameters

No parameters

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "items": [
      {
        "id": "numeric",
        "customerId": "numeric",
        "customerName": "string",
        "orderNumber": "string",
        "prefix": "string",
        "createdAt": "string",
        "deliveredAt": "string",
        "observations": "string",
        "status": "numeric",
        "statusText": "string",
        "responsible": "string",
        "products": [
          {
            "id": "numeric",
            "recipeId": "numeric",
            "recipeName": "string",
            "recipeSku": "string",
            "holded": "boolean",
            "holdedId": "string"
          }
        ]
      }
    ]
   }
   "count": "numeric"
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Obtains a specific resource using an identifier.

Parameters

id: Resource identifier.

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "item": [
      {
        "id": "numeric",
        "customerId": "numeric",
        "customerName": "string",
        "orderNumber": "string",
        "prefix": "string",
        "createdAt": "string",
        "deliveredAt": "string",
        "observations": "string",
        "status": "numeric",
        "statusText": "string",
        "responsible": "string",
        "products": [
          {
            "id": "numeric",
            "recipeId": "numeric",
            "recipeName": "string",
            "recipeSku": "string",
            "holded": "boolean",
            "holdedId": "string"
          }
        ]
      }
    ]
   }
   "count": "numeric"
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Create a resource.

Parameters

No parameters

Request body

The new Ingredients resource

				
					{

}
				
			

Response

				
					{

}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			

Recipes

Gets a list of existing resources.

Parameters

No parameters

Pagination

This endpoint supports pagination, Ex: api.recipok.com/api/final-path?page=1&limit=20

  • page: page number
  • limit: number of items per page

Response

				
					{
  "status": "success",
  "code": 200,
  "message": "Successful operation",
  "data": {
    "items": [
      {
        "id": "numeric",
        "name": "string",
        "unit": "numeric, possible values: 0=Kilograms, 1=Units",
        "ingredientCost": "string",
        "indirectCost": "string",
        "PersonalCost": "string",
        "tags": "array",
        "sku": "string",
        "barcode": "string",
        "expirationDays": "numeric",
        "vat": "numeric",
        "recommendedPVP": "string",
        "pvp": "numeric",
        "wholesalePrice": "numeric",
        "rates": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "allergens": "array, possible values: 0=LUPIN, 1=CELERY, 2=PEANUTS, 3=GLUTEN CEREALS, 4=CRUSTACEANS, 5=TREE NUTS, 6=EGGS, 7=DAIRY, 8=MOLLUSKS, 9=MUSTARD, 910=FISH, 11=SESAME SEEDS, 12=SOY, 13=SULFUR DIOXIDE AND SULFITES
"
      }
    ],
    "pagination": {
      "currentPage": "numeric",
      "totalPages": "numeric",
      "totalItems": "numeric",
      "itemsPerPage": "numeric"
    }
  }
}
				
			

Response – Not authenticated

				
					{
  "status": "error",
  "code": 401,
  "message": "Unauthorized. Authentication is required to access this resource."
}
				
			
Optimized with PageSpeed Ninja