← 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

🌐 Peppol Network (UBL Catalogues)

Best for: Suppliers already using Peppol infrastructure

• Automatic catalogue exchange


• UBL Catalogue format support


• Multi-market capability (SE, NO, DK, FI)


• Requirements: Existing Peppol registration, GLN identifier

🔐 AS2 Protocol (Recommended for Enterprises)


Best for: Large suppliers with existing EDI infrastructure

• Secure, real-time transmission


• Industry standard with delivery confirmations


• Automated acknowledgments and error handling


• Requirements: AS2 software, X.509 certificate

📁 SFTP Upload (File Transfer)


Best for: Suppliers preferring file-based integration

• Secure File Transfer Protocol


• UBL, EDIFACT, Excel, or CSV formats


• SSH key authentication


• Requirements: SFTP client, SSH key pair

📊 Excel/CSV Upload (Simplified)


Best for: Small to medium suppliers without EDI infrastructure

• Simple Excel/CSV format upload


• User-friendly for non-technical users


• Batch processing with validation


• Requirements: Excel or CSV capability, SFTP access

---

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

4. Ongoing Operations



• Regular catalogue updates as needed


• Automated processing reports


• Dedicated support for any issues

---

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 Methods Detail

🔐 AS2 Protocol Setup

What You Need:


• AS2 client software or EDI provider


• X.509 certificate for digital signing


• Unique AS2 Station ID

Connection Details:


AS2 Server: http://transfer.pinchos.se:5080/as2
Your AS2 Station ID: [Provided by Pinchos]
Pinchos AS2 Station ID: PinchosAS2
Message Format: EDIFACT PRICAT
Signing: Required (SHA-256 with RSA)
MDN Receipt: Synchronous requested

Process:


• Configure your AS2 client with provided details


• Send test EDIFACT PRICAT message


• Receive MDN acknowledgment confirming delivery


• Review processing results and resolve any issues

📁 SFTP Upload Setup

What You Need:


• SFTP client (FileZilla, WinSCP, command line)


• SSH key pair (we can generate one for you)

Connection Details:


Server: transfer.pinchos.se
Port: 22
Username: [your-supplier-username]
Authentication: SSH Public Key
Directory: /uploads/[your-supplier-id]/

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)

Process:


• Connect to SFTP server with provided credentials


• Upload catalogue file to your designated directory


• File is automatically processed within minutes


• Receive email confirmation of processing results

📊 Excel/CSV Upload

Template Download:


• Request Excel template from our team


• Template includes all required columns and sample data


• Data validation rules help prevent errors

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)

Optional Columns:


• gtin - 13-digit EAN/GTIN barcode


• brand - Product brand


• minimum_order_qty - Minimum order quantity


• Plus many more for enhanced product data

Process:


• Download and complete Excel template


• Save as .xlsx or export as UTF-8 CSV


• Upload via SFTP to your designated directory


• Receive automated processing report

---

Testing

🧪 Test Environment

We provide a complete test environment:


• Separate test credentials for safe testing


• Sample files and templates


• Dedicated test processing pipeline


• No impact on production systems

✅ Test Success Criteria

File Upload:


• File uploads successfully to correct location


• No connection or permission errors

Data Processing:


• File parsed without format errors


• All required product data validated


• Products imported into test database

Confirmations:


• Processing confirmation email received


• Any errors clearly explained with resolution steps


• Performance meets expected timelines

🔄 Test Process



• Receive test credentials and sample files


• Configure your system with test endpoints


• Send test catalogue with 2-5 sample products


• Review results and resolve any issues


• Confirm successful testing before production go-live

---

Support

📞 Contact Information

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


• Purpose: Commercial discussions, contract negotiations

🆘 Common Issues

Connection Problems:


• Verify credentials received correctly


• Check firewall settings allow connections


• Test network connectivity to our servers

File Format Issues:


• Review file against provided samples


• Check character encoding (UTF-8 for CSV)


• Validate required columns and data types

Processing Errors:


• Review automated error report sent via email


• Check product data completeness and quality


• Verify GTIN codes and pricing information

📚 Additional Resources

Documentation:


• Technical specifications for each integration method


• Sample files and templates


• Troubleshooting guides

Tools:


• EDIFACT validation tools


• Excel templates with built-in validation


• Connection testing utilities

---

Next Steps

🚀 Ready to Start?



• Contact our team at suppliers@pinchos.se


• Provide company and technical information


• Choose your preferred integration method


• Receive setup instructions and credentials


• Begin testing phase


• Go live with production integration

📈 After Integration



• Regular Updates: Send catalogue updates as needed


• Automated Reports: Receive processing confirmations


• Ongoing Support: Dedicated support for any issues


• Performance Monitoring: We monitor integration health


• Account Management: Regular check-ins and optimization

---

Benefits of Integration

⚡ Efficiency



• Automated product data exchange


• Reduced manual data entry errors


• Faster time-to-market for new products

🔒 Security



• Encrypted data transmission


• Secure authentication methods


• Audit trails for all transactions

📊 Visibility



• Real-time processing confirmations


• Detailed error reporting and resolution


• Performance metrics and analytics

🌍 Scalability



• Support for multiple markets and currencies


• Handle large catalogues efficiently


• Easy to add new products and categories

---

Ready to integrate with Pinchos EDI?
Contact us today: suppliers@pinchos.se

---

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