FormNord 3D printing

Returns FormNord 3D printing service details: materials (PETG, ABS) and colours, infill options (15 light / 20 standard / 40 strong / 100 solid %), print settings, maximum size, pricing model, shipping options and delivery time. Delivery to Norway only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object"
}

Get an instant price for printing a 3D model (STL, 3MF, or a zip containing them, max 300 mm on the longest side) and shipping it within Norway. Provide exactly one of file_url, file_base64, stl_text, upload_id (from create_upload_link) or file_id. Returns tilbud_id (the quote_id), total price in NOK with breakdown, estimated weight and print time, and bestill_url: a page where the user can order themselves. To order on the user's behalf, use create_order. The quote is valid for 14 days.

{
  "type": "object",
  "properties": {
    "file_url": {
      "type": "string",
      "description": "Direct https link to an .stl, .3mf or .zip file up to 500 MB (not a web page about the model; Thingiverse/Printables pages block automated downloads, so use create_upload_link for those)."
    },
    "file_base64": {
      "type": "string",
      "description": "The model file encoded as base64 (up to 30 MB; use create_upload_link for larger files)."
    },
    "stl_text": {
      "type": "string",
      "description": "ASCII STL content, for small models you generated."
    },
    "upload_id": {
      "type": "string",
      "description": "upload_id from create_upload_link, after the user has uploaded the file."
    },
    "file_id": {
      "type": "string",
      "description": "fil_id returned by POST https://formnord.no/api/print/fil (multipart upload), for clients that can send HTTP themselves."
    },
    "filename": {
      "type": "string",
      "description": "File name, e.g. \"holder.stl\"."
    },
    "material": {
      "type": "string",
      "enum": [
        "PETG",
        "ABS"
      ],
      "default": "PETG",
      "description": "PETG is the default and suits most parts. ABS for heat resistance."
    },
    "color": {
      "type": "string",
      "description": "PETG: Svart, Hvit, Grå, Blå, Grønn, Rød. ABS: Svart, Hvit. Default Svart."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 1
    },
    "colors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Multicolour 3MF (Bambu Studio/OrcaSlicer) only: one of our colour names per colour slot in the file, in slot order. Omit to get the nearest available colours (shown in fargeplasser)."
    },
    "infill": {
      "type": "integer",
      "enum": [
        15,
        20,
        40,
        100
      ],
      "default": 20,
      "description": "15 = light (lightning infill, 3 walls; maps, figures, decor), 20 = standard (most parts), 40 = strong (load-bearing), 100 = solid."
    },
    "zip_entry": {
      "type": "string",
      "description": "If the file is a zip with several models: which one to quote (name from the list in the previous error)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "kode": {
      "type": "string",
      "description": "Machine-readable error code when ok is false."
    },
    "grunn": {
      "type": "string",
      "description": "Human-readable reason (Norwegian) when ok is false."
    },
    "tilbud_id": {
      "type": "string",
      "description": "quote_id for create_order and get_quote_status."
    },
    "bestill_url": {
      "type": "string"
    },
    "gyldig_til": {
      "type": "string"
    },
    "pris": {
      "type": "object",
      "description": "Price breakdown in NOK; pris.totalt is the total including shipping."
    },
    "prisgrunnlag": {
      "type": "string",
      "enum": [
        "slicet",
        "estimat"
      ]
    },
    "slicing_status": {
      "type": "string"
    },
    "upload_url": {
      "type": "string",
      "description": "Present with kode upload_pending."
    },
    "valg": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Present with kode zip_entry_required."
    }
  },
  "required": [
    "ok"
  ]
}

Look up an earlier quote by quote_id: price, whether it has expired, whether it has been ordered, and the order status (awaiting payment, queued, shipped).

{
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string",
      "description": "tilbud_id from get_print_quote."
    }
  },
  "required": [
    "quote_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "kode": {
      "type": "string",
      "description": "Machine-readable error code when ok is false."
    },
    "grunn": {
      "type": "string",
      "description": "Human-readable reason (Norwegian) when ok is false."
    },
    "tilbud_id": {
      "type": "string"
    },
    "totalt_kr": {
      "type": "number"
    },
    "utlopt": {
      "type": "boolean"
    },
    "bestilt": {
      "type": "boolean"
    },
    "ordrestatus": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "ok"
  ]
}

Create a one-time upload page for the user's model file, for when the user has the file (attached in chat or on their device) and you cannot pass its contents to get_print_quote. Give the user upload_url; when they say it is uploaded, call get_print_quote with upload_id. Accepts STL, 3MF or zip up to 500 MB (large models are simplified automatically for pricing). The link is valid for 24 hours.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "kode": {
      "type": "string",
      "description": "Machine-readable error code when ok is false."
    },
    "grunn": {
      "type": "string",
      "description": "Human-readable reason (Norwegian) when ok is false."
    },
    "upload_id": {
      "type": "string"
    },
    "upload_url": {
      "type": "string"
    },
    "expires_at": {
      "type": "string"
    }
  },
  "required": [
    "ok"
  ]
}

Place an order for a quote on the user's behalf and get a payment link. Only call this after the user has given you their details and explicitly confirmed that they accept the terms (https://formnord.no/print/vilkar) and have the right to use the model. Returns payment_url, which the user opens to pay with Vipps or card (the order is not paid until they do). Calling it again for the same quote returns the same order. Delivery address must be in Norway. If kode is price_pending, slicing is still confirming the price: wait a minute (or poll get_quote_status) and call again.

{
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string",
      "description": "tilbud_id from get_print_quote."
    },
    "customer": {
      "type": "object",
      "properties": {
        "first_name": {
          "type": "string"
        },
        "last_name": {
          "type": "string"
        },
        "email": {
          "type": "string",
          "description": "Order confirmation and shipping updates go here."
        },
        "phone": {
          "type": "string",
          "description": "Norwegian mobile number, used by Posten for delivery notices."
        },
        "address": {
          "type": "string",
          "description": "Street address."
        },
        "postcode": {
          "type": "string",
          "description": "4-digit Norwegian postcode."
        },
        "city": {
          "type": "string"
        },
        "note": {
          "type": "string",
          "description": "Optional note to the workshop, e.g. which side should look best."
        }
      },
      "required": [
        "first_name",
        "last_name",
        "email",
        "phone",
        "address",
        "postcode",
        "city"
      ],
      "additionalProperties": false
    },
    "accepted_terms": {
      "type": "boolean",
      "description": "true only if the user explicitly accepted https://formnord.no/print/vilkar."
    },
    "confirmed_rights": {
      "type": "boolean",
      "description": "true only if the user confirmed they have the right to use and print the model."
    }
  },
  "required": [
    "quote_id",
    "customer",
    "accepted_terms",
    "confirmed_rights"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "kode": {
      "type": "string",
      "description": "Machine-readable error code when ok is false."
    },
    "grunn": {
      "type": "string",
      "description": "Human-readable reason (Norwegian) when ok is false."
    },
    "order_id": {
      "type": "integer"
    },
    "payment_url": {
      "type": "string",
      "description": "The user opens this to pay with Vipps or card."
    },
    "total_nok": {
      "type": "number"
    },
    "already_ordered": {
      "type": "boolean"
    }
  },
  "required": [
    "ok"
  ]
}