Vinted i inne kanały bez API: import zamówień z pliku CSV oraz kanał API klienta

Do czego to służy

Nie każda platforma udostępnia sprzedawcom publiczne API. Zwykli sprzedawcy Vinted go nie mają, więc Zaksio nie może samo pobierać stamtąd zamówień ani wysyłać stanów. Konektor Vinted jest dlatego plikowy: zamiast synchronizacji ma gotowe szablony CSV zamówień i ofert. Możesz wgrać zamówienia (albo listę ofert) z pliku CSV wyeksportowanego z panelu platformy albo przygotowanego w arkuszu. Zamówienia z pliku trafiają do tego samego przepływu co zamówienia z marketplace'ów: rezerwacje, kompletacja, wysyłka.

Gdzie to znaleźć w aplikacji

Obsługę plików mają kanały rodzaju „Ręczny” i „Vinted” (Sprzedaż i logistyka, „Kanały sprzedaży”). Rodzaj „Vinted” jest w aplikacji nadal oznaczony jako „W przygotowaniu”, a ekranu wgrywania pliku jeszcze nie ma, więc w praktyce zamówienia z Vinted prowadź w kanale „Ręczny”, który nazwiesz np. „Vinted”. Import wymaga uprawnienia do zapisu w kanałach, a przy zamówieniach także do zapisu w zamówieniach.

Krok po kroku

1. Wyeksportuj zamówienia z panelu platformy do CSV albo przygotuj arkusz z kolumnami: numer zamówienia, SKU (albo EAN), ilość, cena brutto. Dla Vinted nie ma eksportu, więc po każdej sprzedaży dopisz wiersz z powiadomienia o sprzedaży (numer np. „VINTED-” i numer transakcji). Kupujący zwykle nie udostępnia adresu, bo Vinted Go dostarcza do punktu, więc adres możesz zostawić pusty.
2. Opcjonalnie dodaj: data, klient, e-mail, telefon, ulica, miasto, kod pocztowy, kraj, płatność (pobranie, przelew), opłacone, dostawa, koszt dostawy, uwagi.
3. Wgraj plik jako „zamówienia”. Domyślnie wykonuje się podgląd bez zapisu: liczba zamówień i pozycji, duplikaty, próbka pierwszych 10 zamówień i lista błędów w wierszach (do 100).
4. Popraw błędy w pliku i wgraj go ponownie. Gdy podgląd jest czysty, wykonaj właściwy import.
5. Po imporcie zobaczysz, ile zamówień zaimportowano, ile było duplikatami i ile wymaga Twojej decyzji (np. nierozpoznany towar).

Format pliku

• Kodowanie UTF-8 albo Windows-1250 (typowy eksport z Excela). Separator: średnik, przecinek lub tabulator, rozpoznawany automatycznie.
• Pierwszy wiersz to nagłówki. Rozpoznawane są nazwy polskie i angielskie, bez względu na wielkość liter i polskie znaki, np. „numer zamówienia” lub „order id”, „ilość” lub „quantity”, „cena brutto” lub „price”.
• Wymagane: numer zamówienia, ilość oraz SKU, EAN albo identyfikator oferty.
• Wiele wierszy z tym samym numerem zamówienia tworzy jedno zamówienie z wieloma pozycjami. Dane klienta i dostawy bierzemy z pierwszego wiersza zamówienia.
• Ceny w postaci 12,34 lub 12.34. Stawki VAT: 23, 8, 5, 0, zw, np. Daty np. 31.12.2026 albo w zapisie ISO.
• Limity: plik do 2 MB i do 5000 wierszy.

Błędy i idempotencja

Błędny wiersz (brak numeru zamówienia, zła ilość lub cena) jest pomijany i opisany w liście błędów z numerem wiersza, a reszta pliku importuje się normalnie. Kluczem zamówienia jest jego numer z pliku w obrębie kanału, więc ponowne wgranie tego samego pliku niczego nie dubluje: istniejące zamówienia są liczone jako duplikaty. To samo działa dla listy ofert (kolumny: SKU, EAN lub identyfikator oferty, nazwa, stan, cena), która trafia do zakładki „Oferty” do zmapowania.

Kanał „API klienta”

Kanał rodzaju „API” jest dla własnego sklepu lub systemu, który sam wysyła zamówienia do Zaksio kluczem API z Ustawienia, „API i integracje”. Zaksio niczego z Twojego systemu nie pobiera, nie ma więc kluczy do wpisania ani przycisku „Sprawdź połączenie”. Każde zamówienie ma mieć unikalny identyfikator, który działa jak klucz idempotencji: ponowne wysłanie tego samego identyfikatora nie tworzy drugiego zamówienia. Stany i numery przesyłek odbierasz przez API albo webhooki wychodzące.

Czego jeszcze nie ma

• Ekranu wgrywania pliku w aplikacji: import działa po stronie serwera, a okno do wgrania pliku w kanale dopiero powstaje.
• Pobrania szablonów CSV w aplikacji: gotowe szablony zamówień i ofert Vinted istnieją w konektorze w serwerze, ale ekran kanału ich jeszcze nie udostępnia, a rodzaj „Vinted” ma w aplikacji oznaczenie „W przygotowaniu”. Do tego czasu użyj kanału „Ręczny” i kolumn opisanych wyżej.
• Zamówień w publicznym API v1: adresu do wysyłania zamówień jeszcze nie ma, a zakresy „Zamówienia” i „Przesyłki” są zarezerwowane i nie da się ich wybrać przy tworzeniu klucza. Dziś API v1 obejmuje produkty, stany, kontrahentów i faktury.
• Automatycznej synchronizacji z Vinted: platforma nie daje zwykłym sprzedawcom API (program Vinted Pro Integrations jest tylko dla wybranych kont, na rynkach bez Polski), a według naszych ustaleń jej regulamin ogranicza boty i scrapowanie konta. Zaksio nie loguje się na Twoje konto Vinted, więc synchronizacji nie obiecujemy.