Español
English
Deutsch
Français
Português
Italiano
Nederlands
Polski
SP-API són les sigles de Selling Partner API: la interfície amb què Amazon deixa que un programa extern llegeixi i escrigui al teu compte de Seller Central. Va substituir MWS i va canviar força més que el nom. Des del costat d'Odoo, l'API en si és la part fàcil: són peticions HTTP amb JSON. El que decideix si la integració aguanta un novembre són tres coses que no es veuen a la documentació d'un endpoint: com s'autoritza, quantes crides et deixen fer i quines dades arriben tard per disseny.
L'autorització se signa a Seller Central, no a Odoo
El flux és sempre el mateix: hi ha una aplicació registrada amb un perfil de desenvolupador, i tu, com a venedor, l'autoritzes des del teu compte. D'aquesta autorització surt un refresh token de llarga durada que Odoo desa; amb ell demana, cada cop que ho necessita, un token d'accés que dura una hora. Si algú et demana les credencials de Seller Central per «configurar-ho», alguna cosa va malament: ningú necessita la teva contrasenya per a això. I si revoques l'autorització, la integració s'atura en sec, que és exactament el que ha de passar.
Les dades del comprador van per una porta a part
Nom, adreça i telèfon del comprador són dades personals i Amazon les tracta com a tals: no vénen a la resposta normal d'una comanda. Cal demanar un token restringit per a aquesta consulta concreta, i el permís per fer-ho es concedeix per rol, no per defecte. Conseqüència pràctica a Odoo: pots tenir comandes important-se perfectament i albarans que no es poden expedir perquè falta l'adreça. No és un error del connector; és el permís que no està aprovat.
Els límits de crides són un pressupost, no una velocitat
Cada operació de la SP-API té el seu propi límit, i funciona com un dipòsit que s'omple a un ritme fix i admet una ràfega curta per sobre. Mentre hi ha saldo vas ràpid; quan s'esgota, Amazon respon 429 i cal esperar. Això té una lectura directa per a Odoo: no pots recórrer 4.000 referències cridant-les una per una «perquè així és més simple». Cal agrupar, respectar la capçalera de límit que retorna la mateixa API i reintentar amb espera creixent. I cal que la sincronització manual i el cron comparteixin el mateix fre, perquè el pressupost és del compte sencer, no de cada procés.
Informes davant de crides en directe: per què el teu estoc sempre va amb retard
La SP-API té dues maneres de donar-te dades. Una és la crida directa: preguntes per comandes des d'una data i et respon al moment. L'altra és el sistema d'informes, que és asíncron: sol·licites l'informe, Amazon el prepara quan pot, tu consultes si ja està i després descarregues un fitxer comprimit. L'inventari de FBA i les liquidacions van per aquí. Això vol dir que l'estoc que veus a Odoo és el de l'última descàrrega, no el d'aquest segon, i cap freqüència de cron ho arregla. La resposta correcta no és cridar més: és publicar amb coixí de seguretat i assumir el desfasament.
El sandbox de la SP-API retorna respostes fixes preparades per Amazon. Serveix per comprovar que signes bé les peticions i poc més: totes les seves operacions comparteixen un mateix límit, així que no reprodueix el de cada operació en producció, ni et retorna una comanda pendent sense adreça, ni t'obliga a renovar un token enmig d'una sincronització llarga. Un connector verd al sandbox no està provat. Ho expliquem a tests verds i error en producció.
Els errors que només surten en producció
Són sempre els mateixos i cap no apareix el primer dia. Comandes en estat pendent que arriben sense imports ni adreça i que cal tornar a llegir més tard. Paginació: la primera pàgina entra i la resta es perd si ningú segueix el testimoni de continuació. Finestres de dates mal calculades per zona horària, que deixen un forat de comandes just al canvi de dia. Tokens que caduquen durant una sincronització llarga i que cal renovar a mitges. I la regió equivocada: l'aplicació és global, però el compte de venedor no, i demanar les comandes d'Alemanya a l'endpoint de Nord-amèrica no respon «regió incorrecta», respon «Access to requested resource is denied». Sembla un problema de permisos, així que es regeneren credencials que estaven bé mentre l'error continua a la URL.
On ha de viure això dins d'Odoo
Una crida a Amazon no pot penjar de la validació d'un albarà. Si l'API triga, l'usuari es queda mirant una rodeta i, si falla, perd la feina feta. El lloc d'aquestes crides és una tasca programada o una cua de treballs, amb el seu reintent, el seu registre de què es va demanar i què va contestar Amazon, i amb operacions idempotents: repetir una sincronització no pot crear la comanda dues vegades. Aquest registre és el que després et permet discutir amb el suport d'Amazon amb dades, en comptes d'amb impressions. La resta del patró, aplicat a les comandes que no apareixen, és a per què les comandes d'Amazon no entren a Odoo.
Quan no cal que construeixis res
Si vens en un sol marketplace, amb poques referències i només necessites que les comandes entrin, el connector d'Amazon que porta Odoo Enterprise de sèrie et pot bastar. Val la pena provar-lo abans de pagar per res. La conversa canvia quan hi ha diversos països amb els seus impostos, estoc compartit amb altres canals, liquidacions que quadrar o confirmacions d'enviament amb termini. Aquí és on el nostre connector d'Amazon per a Odoo fa la feina: SP-API amb control de límits, informes, FBA i FBM, a Odoo 17, 18, 19 i 20.
Preguntes freqüents
Cal un compte de desenvolupador d'Amazon per fer servir la SP-API?
L'aplicació ha d'estar registrada sota un perfil de desenvolupador, però qui autoritza ets tu des del teu Seller Central. L'autorització és teva i la pots revocar quan vulguis.
Es pot consultar l'estoc d'Amazon en temps real?
No com la gent s'imagina. L'inventari arriba sobretot per informe, que és asíncron, així que sempre hi ha un desfasament de minuts. Per això el coixí de seguretat importa més que la freqüència de sincronització.
Què passa si Amazon em retorna 429 en plena campanya?
Res de greu si la integració reintenta amb espera creixent i posa en cua el que queda pendent. És greu si el procés es mor i ningú no se n'assabenta fins que falten comandes: per això el registre i l'alerta importen tant com la crida.
Enllaços útils dins de FlexigoTech
El que fem sobre això
La teva integració amb la SP-API falla i no saps per on?
Digues-nos en quins marketplaces vens, si fas servir FBA, FBM o tots dos, i quin error concret veus al registre. Mirem si és autorització, límits de crides o una finestra de dates mal calculada. Escriu a comercial@flexigobe.com o agenda una trucada.