← Back to Documentation Home

Pinchos Supplier Integration Guide

Welcome to Pinchos EDI

This guide will help you integrate your product catalogue with Pinchos' Electronic Data Interchange (EDI) system. We support multiple integration methods to accommodate different technical capabilities and business requirements.

Integration Methods

Getting Started

Contact Us

Ready to integrate? Contact our team:

• Email: suppliers@pinchos.se
• Subject: "New Supplier Integration - [Your Company Name]"

Information We Need

Company Information:

• Legal company name and display name
• Business registration number
• GLN (Global Location Number) if available
• Primary market (Sweden, Norway, Denmark, Finland, Germany)

Contact Details:

• Primary business contact (name, email, phone)
• Technical contact for integration (name, email, phone)
• Email address for automated processing reports

Technical Preferences:

• Preferred integration method (see options above)
• Expected catalogue size and update frequency
• Product categories you supply

Integration-Specific Requirements:

• For AS2: Your preferred AS2 Station ID, X.509 certificate
• For SFTP: Your SSH public key (or we can generate one)
• For Peppol: Your GLN and Peppol registration details

Integration Process

1. Initial Setup (1-2 business days)

• We configure your integration method
• Generate and send you secure access credentials
• Provide technical specifications and sample files

2. Testing Phase (2-3 business days)

• You send test catalogue files
• We validate processing and provide feedback
• Any issues are resolved together

3. Go-Live (1 business day)

• Production credentials provided
• First production catalogue processed
• Ongoing monitoring and support begins

Data Requirements

Product Information Required

Essential Data:

• Product Identification: GTIN/EAN barcode (preferred), Supplier item number (required)
• Product Description: Name and description
• Pricing: Unit price with currency (SEK, NOK, DKK, EUR)
• Units: Base quantity and unit of measure

Enhanced Data (Recommended):

• Brand information
• Product categories
• Minimum order quantities
• Packaging details
• Country of origin

Supported File Formats

EDIFACT PRICAT:

• UN/EDIFACT D.96A standard
• Price/Catalogue message format
• Character set: UNOA (ASCII) or UNOC (UTF-8)

UBL Catalogue:

• UBL 2.1 Catalogue format
• XML structure with product lines
• OASIS UBL 2.1 standard

Excel Spreadsheet:

• Microsoft Excel (.xlsx) format
• Single "Products" worksheet
• Standardized column headers

CSV Files:

• UTF-8 encoding required
• Comma-separated values
• Header row with standardized columns

Integration Setup Details

AS2 Protocol

• AS2 client software or EDI provider required
• X.509 certificate for digital signing (minimum 2048-bit RSA)
• SHA-256 with RSA signing required
• Synchronous MDN receipt

SFTP Upload

• SFTP client required (FileZilla, WinSCP, or command line)
• SSH public key authentication (no passwords)
• Each supplier receives individual credentials with isolated directory access

File Naming Convention:

Pattern: [TYPE]_[YYYYMMDD]_[SEQUENCE].[EXTENSION]
Examples:
- PRICAT_20241201_001.edi (EDIFACT)
- CATALOGUE_20241201_001.xml (UBL)
- PRODUCTS_20241201_001.xlsx (Excel)
- PRODUCTS_20241201_001.csv (CSV)

Excel/CSV Required Columns

• supplier_item_id - Your internal product code
• product_name - Product name/description
• unit_price - Price per unit (numeric)
• currency - ISO currency code (SEK, NOK, DKK, EUR)
• unit_of_measure - Unit code (PCE, KG, L, M)

Testing

We provide a complete test environment with separate credentials. No impact on production systems.

1. Receive test credentials and sample files
2. Configure your system with test endpoints
3. Send test catalogue with 2-5 sample products
4. Review results and resolve any issues
5. Confirm successful testing before production go-live

Support

Integration Support:

• Email: edi-support@pinchos.se
• Response Time: Within 4 hours during business hours
• Coverage: Monday-Friday, 08:00-17:00 CET

Business Development:

• Email: suppliers@pinchos.se

Document Version: 1.0
Last Updated: August 26, 2025
Support: edi-support@pinchos.se