Obriym CRMObriym CRMCustomer flow workspace
IAFonctionnalitésBien démarrerTarifsFeuille de routeIntégrationsBlog
FR
  • ukУкраїнська
  • enEnglish
  • itItaliano
  • deDeutsch
  • frFrançais
ConnexionCommencer
IAFonctionnalitésBien démarrerTarifsFeuille de routeIntégrationsBlogConnexionCommencer
Blog

Inscriptions

Rozetka Vendeur API: ordres de tirage lorsqu’il n’y a pas de sangles

Rozetka n’envoie pas de webhooks et de filtres par la date seulement. Voici à quoi ressemble une boucle d’importation fiable à cause de cela — et les trois choses qui brisent tranquillement une boucle naïve.

16 août 2026Mise à jour 11 septembre 2026

La plupart des intégrations commencent par demander où Rozetka enverra son webhook. La réponse n’est nulle part. Rozetka’s Vendeur API est une demande API, pas un événement API: tant que vous ne demandez pas s’il y a de nouvelles commandes, vous n’en entendrez pas parler.

Ça change toute l’architecture. Au lieu d’un paramètre qui attend, vous avez besoin d’une boucle qui fonctionne sur un horaire, se souvient où il s’est arrêté la dernière fois, et ne crée pas de duplicata lorsque la même exécution se produit deux fois. Ci-dessous se trouve le contrat tel qu’il se comporte réellement, et les trois endroits où une mise en œuvre naïve perd silencieusement les commandes.

Le contrat : que savoir avant la première demande

Les valeurs ci-dessous proviennent de la documentation officielle du Vendeur API. L’adaptateur Obriym CRM est construit dans le cadre du présent contrat; statut — bêta.

Base
api-seller.rozetka.com.ua — un hôte séparé du site public
Authentification
POST /sites avec le login du vendeur et le mot de passe base64 encodé. La réponse porte un jeton qui vit environ 24 heures.
Ordres de lecture
GET /orders/search — toujours avec des articles en ligne, livraison et l’acheteur élargi, sinon la commande arrive avec ni produits ni une adresse
Filtre de temps
Par DATE, pas à temps. Le contrat n’offre aucune précision "depuis cette minute".
Éléments de ligne
Un tableau d’achats à l’intérieur de la commande; une ligne marquée comme supprimée est présente dans la réponse et doit être ignorée
Statuts
Numerique, et dépendant de la configuration de l’espace client — pas une liste universelle
État de rédaction
PUT /orders/{id} — après connexion, avec le même jeton
Produits
GET /items/search to read; PUT /items/update-price-stock/{id} pour prix et stock. Créer une liste au-dessus de API n’est pas possible.
Monnaie
Hryvnia

La boucle d’importation

  1. 1

    Connexion et jeton

    Échangez le login et le mot de passe pour un jeton. Cache-le : la connexion à chaque demande ajoute de la latence et du bruit inutile dans la piste de vérification du marché.

  2. 2

    Lire le curseur

    Renseignez-vous sur la date de la dernière sortie réussie. Sur la toute première manche prendre un jour en arrière, pas "tout le temps" : importer l’historique entier en course est le moyen le plus rapide pour un timeout et un état partiel opaque.

  3. 3

    Interroger avec un chevauchement

    Demander des commandes changées depuis la date du curseur MINUS un jour. Le chevauchement n’est pas paranoïa — il suit directement le filtre de date seulement (détaillé ci-dessous).

  4. 4

    Normaliser

    Cartez la réponse dans votre propre modèle de commande avec une fonction pure et aucun effet secondaire: il peut ensuite être testé contre une charge utile enregistrée sans appel réseau du tout.

  5. 5

    Écrire l’idémpotent

    Créez l’ordre sous une clé construite à partir de l’identifiant de commande Rozetka. Un essai répété ne crée pas de second ordre — il trouve celui existant.

  6. 6

    Enrichissement

    Sur chaque laissez-passer, non seulement à la création, rafraîchir le statut, le paiement, le mode de livraison et le numéro de lettre de transport dès que Rozetka les retourne.

  7. 7

    Écrivez le curseur

    Et seulement après un succès passé déplacer le curseur. Un curseur avancé avant le traitement perd exactement les commandes que l’exécution a échouées.

Pourquoi un curseur quotidien a besoin d’un chevauchement

Le filtre « modifié depuis la date X » n’a pas de composante temporelle. Cela signifie que vous ne pouvez pas vous demander ce qui a changé au cours des 15 dernières minutes — seulement ce qui a changé aujourd’hui.

D’où le problème de minuit. Une course à 23:58 voit les ordres d’aujourd’hui et écrit le curseur comme "aujourd’hui". Une course à 00:03 demande des commandes changées depuis "aujourd’hui" — mais aujourd’hui est maintenant une date différente, et un ordre créé à 23:59 terres dans aucune requête. Il disparaît tout simplement, et le pire est que rien n’échoue : les grumes sont propres, les compteurs sont verts, et l’ordre n’est pas là.

Le remède est bon marché : toujours demander à partir de la date du curseur moins un jour. Vous relisez à chaque fois un jour d’ordres déjà connus — c’est exactement pourquoi l’étape précédente, idempotency, est obligatoire plutôt que agréable à avoir. Sans elle, le chevauchement fabriquerait des duplicatas tous les jours; avec lui, le chevauchement est libre.

Trois choses qui brisent une mise en œuvre naïve

  • Un élément de ligne marqué comme supprimé arrive dans la réponse aux côtés de ceux en direct. Passez-le ou vous obtenez une commande contenant un produit que l’acheteur n’a jamais acheté, et un total qui ne correspond pas à l’espace client.
  • Les statuts numériques ne sont pas universels : les mêmes nombres peuvent signifier des états différents dans différentes armoires. Ainsi, la cartographie d’état appartient à UN bloc explicite que vous pouvez voir et vérifier, pas comme constantes dispersées dans le code. Et une transition dont vous n’êtes pas sûr est plus sûre qu’on ne le pense.
  • Le passage à la livraison nécessite une lettre de transport. Définir "acheminé" sans numéro de lettre de route n’est pas un état Rozetka acceptera l’ordre dans, de sorte que la transition ne devrait pas faire partie d’une synchronisation automatique inverse.

Prix et stocks: seulement ce qui est déjà publié

Mise à jour du prix et de la quantité travaux par SKU: Rozetka le champ d’article de la liste est jumelé au produit SKU dans votre système. Cela implique deux choses. Tout d’abord, la discipline SKU compte plus que n’importe quel code: un produit sans SKU, ou un produit qui diffère au cas par cas ou un espace errant, ne correspondra pas. Deuxièmement, le API ne met à jour que les listes existantes; il ne peut pas créer un produit, donc publier une nouvelle position reste une action dans l’espace client du vendeur.

La quantité ne doit être envoyée que pour les produits où vous suivez réellement le stock. Un produit fabriqué sur commande ne devrait pas recevoir une quantité de zéro simplement parce que son champ de stock est vide, ce qui le retire de la vente sans raison du tout.

Chaque écriture dans le compte d’un autre est désactivée par défaut

Un vendeur arrive avec des produits qui vivent déjà sur le marché. Ainsi, la lecture peut être mise en marche immédiatement, tandis que toute écriture — prix, stock, statuts — attend une course sèche qui montre exactement ce qui changerait tout en ne changeant rien. Ce n’est pas une paranoïa: une erreur de prix en vrac poussé à travers un catalogue en direct coûte plus que l’ensemble de l’intégration.

Foire aux questions

Est-ce que Rozetka ont des hooks de commande ?

C’est pas vrai. Le Vendeur API répond aux demandes mais n’émet aucun événement, de sorte que les nouvelles commandes ne peuvent être récupérées que par sondage périodique. Un intervalle pratique est de 15 minutes : le plus souvent rien n’achète étant donné le filtre de date seulement, moins souvent est perceptible pour un gestionnaire.

Combien de temps un jeton Vendeur API vit-il?

Environ un jour. Se connecter paresseusement — quand il n’y a pas de jeton ou qu’il cesse d’être accepté — plutôt que sur chaque appel.

Pourquoi le mot de passe base64 est-il encodé ?

C’est ce que précise le contrat de connexion. C’est un encodage, pas un chiffrement : le mot de passe doit toujours être stocké crypté de votre côté, et l’échange doit se faire sur HTTPS.

Un produit peut-il être créé sur Rozetka sur API?

C’est pas vrai. Les API peuvent lire les listes existantes et mettre à jour leur prix et leur stock. La création d’une nouvelle position se produit dans le cabinet du vendeur.

Comment puis-je éviter les ordres en double sur une course répétée?

Avec une clé idempotency construite à partir de l’identifiant de commande Rozetka, appliquée à la base de données écrire. C’est une condition préalable, pas une optimisation : le curseur relise les ordres connus tous les jours.

Ai-je besoin d’un travailleur séparé?

En Obriym CRM, non: le vote est construit et fonctionne sur un horaire du côté CRM, donc le vendeur doit seulement enregistrer leur connexion de cabinet. Si vous construisez l’intégration vous-même, vous avez besoin d’un travailleur — et la boucle ci-dessus est écrite pour elle.

Plutôt ne pas construire ça vous-même ?

En Obriym CRM, la boucle de vote, idempotency, l’enrichissement de statut et la synchronisation inverse existent déjà — vous n’enregistrez que votre login de cabinet Rozetka. Beta: disponible pour se connecter aujourd’hui; les capacités du canal sont encore affinées.

Essayez-le gratuitement.

En savoir plus

Intégrations mentionnées

  • Rozetka

    Bêta

    Le plus grand marché de l’Ukraine: les commandes arrivent dans le CRM de leur propre, les statuts et les stocks retournent au cabinet du vendeur, et les questions de l’acheteur deviennent des pistes avec un propriétaire et une étape suivante.

    En savoir plus
  • Prom.ua

    Disponible

    Les commandes, les paiements et la livraison arrivent seuls. Les questions d’acheteur deviennent des pistes vous répondez directement du CRM, sans ouvrir l’espace client Prom.

    En savoir plus
  • Nova Poshta

    Disponible

    Pas de changement vers le cabinet du transporteur: la lettre de route est créée dans le CRM, et les états de livraison se mettent à jour.

    En savoir plus

Bêta: Beta: disponible pour se connecter aujourd’hui; les capacités du canal sont encore en cours de perfectionnement.

Commencez.

Commencez par un ordre réel, pas des données de démonstration.

Inscrivez-vous et votre espace de travail est créé automatiquement. Connectez un canal de vente, ajoutez un produit et prenez votre première commande ou demande — le CRM pointe à l’étape suivante elle-même.

Démarrer gratuitementComment commencer, étape par étape
Obriym CRMObriym CRMCustomer flow workspace

Obriym CRM réunit les ventes et le commerce en ligne : prospects, opportunités, commandes et fidélisation des clients dans un seul espace.

Un produit OBRIYM

  • crm@obriym.com
  • OBRIYM
  • Serhii Oberemchuk

Individual Entrepreneur Oberemchuk Serhii Oleksandrovych · Enregistrement d’État 178752761226

Produit

  • Commerce CRM
  • IA
  • Caractéristiques
  • Commencer
  • Tarifs
  • Comparer
  • Blog
  • Feuille de route
  • Intégrations
  • Documentation API

Entreprise

  • Environ OBRIYM
  • Fondateur
  • Personne à contacter
  • Feuille de route

Développeurs

  • Pour les développeurs
  • Documentation API
  • JS Widget
  • API de collecte de prospects
  • API de commandes

©2026Obriym CRM par OBRIYM. Construit pour les ventes de production et les équipes de commerce électronique.

Conditions d’utilisationOffre publiquePaiement et remboursementsPolitique de confidentialitéSous-traitantsTraitement des donnéesMentions légalesSuppression des donnéesTarifsDocumentation API