Click Post CSV-importfouten oplossen: adresvelden, tekencodering en postcodes
Als een CSV-import mislukt, lees je de melding op het scherm en zoek je de betrokken regels op. Vergelijk daarna de kolomvolgorde, codering en verplichte velden met de template van Japan Post. Japan Post publiceert geen statistieken over foutoorzaken, dus deze gids rangschikt de oorzaken niet. De voor-en-na-voorbeelden hieronder zijn fictief. Bekijk ook de Shopify × Click Post-verzendgids voor het volledige proces.
Controleer de officiële CSV-vereisten
Voor de bulktoepassing van Click Post gebruik je de officiële CSV-template. Behoud de kolomnamen en volgorde. De officiële CSV-handleiding vermeldt deze hoofdvereisten:
| Veld | Officiële vereiste |
|---|---|
| Postcode | 7 cijfers op halve breedte zonder koppelteken, of 7 cijfers op halve breedte plus één koppelteken op halve breedte (in totaal 8 tekens) |
| Naam ontvanger | Verplicht; maximaal 20 tekens op volle breedte of 40 op halve breedte, exclusief aanspreektitel |
| Aanspreektitel | “Sama” of “Onchū” |
| Adresregels 1–4 | Minimaal één vereist; elk veld staat 20 tekens op volle breedte of 40 op halve breedte toe |
| Inhoud | Verplicht; maximaal 15 tekens op volle breedte of 30 op halve breedte |
| CSV | CSV-tekst in Shift-JIS; maximaal 40 zendingen per upload |
De handleiding zegt ook dat je de kopregel van de template niet mag wijzigen. Begin je met een Shopify-export of gegevens uit een ander systeem, pas dan de veldnamen, kolomvolgorde en tekenlimieten aan voordat je uploadt.
Corrigeer fouten aan de hand van voorbeelden
De voor-en-na-voorbeelden zijn fictief. Het zijn geen echte foutmeldingen of bestaande adressen.
| Controle | Fictief voorbeeld vóór correctie | Fictief voorbeeld na correctie |
|---|---|---|
| Adresveld | Vul een fictief Japans adres van 21 tekens op volle breedte volledig in adresveld 1 in | Behoud alle onderdelen: zet de eerste 11 tekens (prefectuur, stad en wijk) in adresveld 1 en de gebouwnaam van 10 tekens in adresveld 2. Samengevoegd in de juiste volgorde vormen ze het oorspronkelijke adres; controleer de limiet van elk veld |
| Postcode | Cijfers en koppelteken op volle breedte | 7 cijfers op halve breedte zonder koppelteken, of 7 cijfers op halve breedte plus één koppelteken op halve breedte (in totaal 8 tekens) |
| Codering | Opgeslagen als UTF-8 | Opgeslagen als Shift-JIS zoals de officiële gids aangeeft |
| Kolomvolgorde | Kolommen opnieuw gerangschikt | Behoud de kopregel en kolomvolgorde van de officiële template |
Verwijder geen straatnummers, gebouwnamen of andere adresgegevens om binnen een veldlimiet te blijven. Voeg de velden in volgorde samen en controleer of ze het oorspronkelijke adres vormen en duidelijk blijven voor bezorging. Bekijk Click Post-adresfouten voorkomen voor meer voorbeelden en controles van adresvelden.
Bereid de CSV voor en dien een bulktoepassing in
1. Bepaal de omvang van de importfout
Controleer op het Click Post-scherm voor bulktoepassingen of het hele bestand is mislukt of alleen bepaalde regels. Gebruik de melding en betrokken regels om het bestand met de officiële template te vergelijken.
2. Controleer CSV-indeling, codering en kopregel
Controleer of het bestand CSV-tekst in Shift-JIS is. Controleer of er geen kolommen zijn toegevoegd, verwijderd of verplaatst en of de kopregelnamen niet zijn gewijzigd.
3. Controleer verplichte velden en veldlengtes
Controleer postcode, naam van de ontvanger, minimaal één adresveld en inhoud. Voor adresregels 1–4, de naam en de inhoud gelden tekenlimieten uit de officiële gids. Verdeel lange adressen leesbaar over meerdere velden.
4. Controleer cijfers en koppeltekens in de postcode
Vul 7 cijfers op halve breedte zonder koppelteken in, of 7 cijfers op halve breedte plus één koppelteken op halve breedte (in totaal 8 tekens). Vervang cijfers en koppeltekens op volle breedte door tekens op halve breedte.
5. Splits uploads met meer dan 40 zendingen
Eén upload bevat maximaal 40 zendingen. Verdeel bij 41 of meer bestellingen de regels zodat elk bestand maximaal 40 bevat en upload de bestanden afzonderlijk. Vergelijk daarna de bestelnummers en aantallen om ontbrekende of dubbele regels te vinden. Bekijk Click Post-bulkaanvragen gebruiken voor uitgebreide stappen voor het splitsen van CSV’s en de bulkaanvraag.
Exporteer CSV uit Shopify en registreer trackingnummers
De Shopify-vermelding voor Instant Ship! for Click Post beschrijft CSV-export van geselecteerde Shopify-bestellingen en automatische adresopsplitsing. Controleer de geëxporteerde bestelgegevens en de vereisten van de officiële template voordat je uploadt. De vermelding zegt niet dat de app CSV's automatisch in groepen van 40 splitst; verdeel bestanden indien nodig zelf.
Nadat Click Post de verzendlabels heeft aangemaakt, upload je het originele, door Click Post uitgegeven label-PDF naar de app. Controleer de kandidaat-trackingnummers en de bijbehorende bestellingen die de app toont en bevestig daarna de registratie bij de juiste Shopify-bestellingen. Bekijk de appgids voor de vermelde functies.
Veelgestelde vragen
Wat is de meest voorkomende oorzaak van een Click Post CSV-importfout?
Japan Post publiceert geen gegevens over de frequentie van fouten, dus de oorzaken zijn niet te rangschikken. Lees eerst de melding op het scherm en controleer daarna de kolomvolgorde, Shift-JIS-codering, verplichte velden en tekenlimieten van adresvelden met de officiële template.
Kan ik een Shopify-CSV ongewijzigd naar Click Post uploaden?
Niet altijd. Koppel de geëxporteerde velden aan de kolommen en vereisten van de Click Post-template en sla het bestand op als CSV-tekst in Shift-JIS. Er zijn maximaal 4 adresvelden, elk met een limiet van 20 tekens op volle breedte of 40 op halve breedte.
Waarom toont een CSV die op een Mac is gemaakt onleesbare tekens?
Als de CSV is opgeslagen in een andere codering dan Shift-JIS, kunnen tekens onleesbaar zijn of kan de import mislukken. Controleer de bestandscodering en sla het opnieuw op in Shift-JIS, zoals de officiële gids voorschrijft.
Hoe los ik een fout over de adreslengte op?
Elke adresregel van 1 tot en met 4 mag maximaal 20 tekens op volle breedte of 40 op halve breedte bevatten. Verdeel een lang adres leesbaar over meerdere velden en controleer het aantal tekens in elk veld.
Wat doe ik als een CSV de limiet van 40 zendingen overschrijdt?
Volgens de officiële gids kunnen maximaal 40 zendingen per CSV-upload worden ingediend. Verdeel de bestelregels zodat elk bestand maximaal 40 zendingen bevat en upload de bestanden afzonderlijk.
Vergelijk de CSV met de officiële template en de melding op het Click Post-scherm voordat je uploadt. Lees meer over CSV-export uit Shopify-bestellingen en het controleren en registreren van voorgestelde trackingnummers uit de originele label-PDF op de Shopify App Store-pagina en in de appgids.
