# Contact Shipco Circuits

## Quote Requests

For PCB quotes, use our online form: https://ship.ie/quote/

Include:
- Gerber files or ODB++ (preferred)
- Quantity and delivery requirements
- Country-of-manufacture restrictions (e.g., Non-China, South Korea, Europe/UK, or separate prototype vs. production options)
- Special requirements (materials, certifications, End-Use Statements, etc.)

If your drawings or Gerber data require a signed End-Use Statement (EUS) or NDA before release, you can submit your quote request with basic board parameters and note the EUS requirement so we can complete compliance sign-off first.

## AI Agent & Programmatic Quote Preparation

AI assistants (Claude, ChatGPT, Perplexity, Cursor, Claude Code) and automated scripts can prepare a quote request for human review using either of two paths:

### Option 1: Pre-Filled Quote Link (For Web-Chat LLMs Without Outbound POST)
Construct a URL-encoded clickable link with query parameters to pre-populate `https://ship.ie/quote/`:

```text
https://ship.ie/quote/?projectName=St-E-Mesh-V1&layers=2&material=Polyimide&thickness=0.11mm&finish=ENIG&copperOuter=0.5oz&quantity=8%2C%2016&region=North%20America&timeline=Quick-turn%20(1-2%20weeks)&description=2-layer%20UV-laser-cut%20polyimide%20flex%20with%200.2mm%20FR-4%20stiffener
```

**Supported fields & normalization rules:**
- **Required before final browser submission:** `name`, `email`, `company`, `region` (`Europe`, `North America`, or any country/region string, which auto-selects `Other` and fills `regionOther`), plus either `description` or uploaded design files.
- **Optional specification fields:**
  - `projectName` (aliases: `partName`, `boardName`): string (max 200 chars)
  - `phone`: string (max 50 chars; URL-encode `+` as `%2B`)
  - `quantity`: positive integer or comma/slash-separated list (e.g. `"8, 16"` sets primary quantity to `8` and preserves `Quantities requested: 8, 16` in `special` notes)
  - `timeline`: `Standard (3-4 weeks)`, `Quick-turn (1-2 weeks)`, `Rush (<1 week)`, `Flexible` (or aliases `standard`, `quick-turn`, `asap`, `urgent`, `rush`; any custom timeline string sets `Flexible` and preserves the exact text in `special`)
  - `layers` (alias: `layerCount`): `1`, `2`, `4`, `6`, `8`, `10`, `12`, `14`, `16`, `20`, `24`, `30`, `40+` (non-standard counts such as `18` are preserved in `special`)
  - `thickness`: include units, e.g. `0.4mm`, `0.8mm`, `1.0mm`, `1.2mm`, `1.6mm`, `2.0mm`, `2.4mm`, `3.2mm`, or any custom string such as `0.85mm` (auto-selects `Other` and fills `thicknessOther`)
  - `material`: `Standard FR-4`, `High-Tg FR-4`, `Halogen-Free FR-4`, `Megtron`, `Rogers/Arlon`, `PTFE/Teflon`, `Polyimide`, `Aluminum base`, `Hybrid`, or any specific laminate callout such as `0.813mm Rogers RO4003C` (auto-selects `Other` and fills `materialOther`)
  - `finish` (alias: `surfaceFinish`): `ENIG`, `ENEPIG`, `HASL lead-free`, `HASL leaded`, `OSP`, `Immersion Silver`, `Immersion Tin`, `Hard Gold`, `Carbon Ink`, or custom string
  - `copperOuter` / `copperInner`: `0.5oz (18µm)`, `1oz (35µm)`, `2oz (70µm)`, `3oz (105µm)`, `4oz (140µm)`, `6oz (210µm)`, `10oz+ (heavy copper)` (aliases `0.5oz`, `18um`, `1oz`, `35um`, etc. are normalized automatically; custom weights fill `*Other`)
  - `delivery`: `Singles`, `Panelized`, `Not sure`
  - `countryOfOrigin`: `Non-China required (e.g. South Korea, Europe/UK)`, `Dual quote: fast-turn prototype vs. non-China production`, `Europe / UK only`, or custom string
  - `special`: string (max 2,000 chars)
  - `description`: string (max 10,000 chars)
  - `stencil`: `yes` / `true` (with optional `stencilMaterial`, `stencilThickness`, `stencilSide`, `stencilFrame`, `stencilNotes`)

### Option 2: Staged Quote Draft API (For CLI Agents & Python Scripts With HTTP Access)
Stage the specification fields and optional Gerber `.zip` / drawing files via `POST https://ship.ie/api/quote/stage/`:
- **Content-Type:** `multipart/form-data` (use field name `files` for design archives/drawings, up to 20 files / 100 MB total) or `application/json` (fields only; JSON cannot upload binary files).
- **Accepted file extensions:** `.zip`, `.rar`, `.tgz`, `.gz`, `.pdf`, `.gbr`, `.ger`, `.gtl`, `.gbl`, `.gts`, `.gbs`, `.gto`, `.gbo`, `.gko`, `.gm1`, `.gtp`, `.gbp`, `.drl`, `.xln`, `.odb`, `.dxf`, `.gds`, `.gdsii`, `.step`, `.stp`, `.csv`, `.txt`, `.xml`, `.jpg`, `.jpeg`, `.png`, `.gif`, `.art`, `.cam`, `.exc`, `.ncd`, `.tap`.
- **Authorization & privacy note:** Uploading files to `/api/quote/stage/` transfers those files to Shipco's encrypted storage (24-hour draft expiry) so they are ready when the user opens `claim_url`. Confirm the user wants to upload their files to Shipco before calling this endpoint, and treat the returned `claim_url` as a confidential bearer link. Staging does **not** submit the quote or send any emails; the quote is submitted only when the user opens `claim_url` in their browser and clicks **Send Quote Request**.

```bash
curl -X POST https://ship.ie/api/quote/stage/ \
  -F "name=Jane Doe" \
  -F "email=jane@example.edu" \
  -F "company=Example University" \
  -F "region=North America" \
  -F "projectName=patchArr32" \
  -F "quantity=2" \
  -F "layers=2" \
  -F "material=0.813mm Rogers RO4003C" \
  -F "thickness=0.85mm" \
  -F "finish=ENIG" \
  -F "copperOuter=0.5oz" \
  -F "description=Single continuous 850 x 60 mm piece, no solder mask" \
  -F "files=@patchArr32_gerbers.zip"
```

**Response (`201 Created`):** returns `{"success": true, "token": "...", "claim_url": "https://ship.ie/quote/?claim=<token>", "expires_at": "...", "normalized_fields": {...}, "staged_files": [...]}`. Present `claim_url` to the user to review and submit in their browser.

## General Inquiries

Contact form: https://ship.ie/contact/

## Locations

### Ireland (Headquarters)
**Shipco Circuits Ltd**
- Primary office for European customers
- Technical support and engineering review

### Canada
**Shipco Circuits NA Inc**
- Vancouver, British Columbia
- Serves North American customers
- Local support for US and Canadian projects

## What to Expect

- **Response time**: Typically within 1 business day
- **Technical review**: Every quote includes DFM review
- **No automated quoting**: Real engineers review your files
