APIa eta integrazioak (CRM, Make, n8n)
Konektatu zure CRMa edo ERPa Sattotalekin API gakoen bidez: sinkronizatu bezeroak eta hornitzaileak automatikoki eta modu seguruan
Sattotalen APIari esker, beste programa batek —zure CRMak, zure ERPak, Makek, n8n-k, Zapierrek edo zuk egindako script batek— zure erakundeko bezeroak eta hornitzaileak irakurri eta sor ditzake, inork CSV bat eskuz inportatu beharrik gabe. API gakoen bidez kontrolatzen da: administratzaileak Ezarpenak → API atalean sortzen ditu, bakoitza bere izenarekin eta baliabideko baimenekin, eta edozein unetan baliogabe daitezke. Hemen duzu zer egiten duen, gakoa nola sortu, APIari nola deitu eta Makekin sinkronizazio bat urratsez urrats nola muntatu.
Konektatu zure CRMa eta zure automatizazioak
HTTP eskaera bat egiteko gai den edozein tresnak (Make, n8n, Zapier, zure CRM edo ERP propioa) bezeroak eta hornitzaileak irakurri, sortu eta egunera ditzake.
Izena eta baimenak dituzten gakoak
Gako bat integrazio bakoitzeko, eta gako bakoitzaren barruan baimen bat baliabide bakoitzeko: hornitzaileak irakurtzeko baimena eman dezakezu bezeroetan idazteko baimenik eman gabe. Gehienez 10 gako aktibo erakunde bakoitzeko.
Sinkronizazio inkrementala
actualizadoDesde parametroarekin, azken exekuziotik aldatu diren bezeroak edo hornitzaileak soilik ekartzen dira: ezin hobea minutu gutxiro exekutatzen den eszenatoki baterako.
Diseinuz segurua
Gakoa behin bakarrik erakusten da eta modu itzulezinean zifratuta gordetzen da. Gako bakoitzak bere erakundeko datuetara soilik du sarbidea, eta berehala baliogabetzen da.
Nork erabil dezakeen
Gakoak erakundeko administratzaileek sortzen eta baliogabetzen dituzte. APIa ordainpeko planetan (Basic, Pro eta Enterprise) eta proba-aldian dago barne; doako planean, pantailak giltzarrapo bat erakusten du plana aldatzeko aukerarekin. Gako batek beti erakundearen izenean jarduten du, ez pertsona baten izenean: ez ditu inongo teknikariren baimenak heredatzen, eta ez da taldean erabiltzaile gisa agertzen.
Gako bat nola sortu
Sartu Ezarpenak → API atalean
Alboko menuan, Ezarpenak, «API» txartela. Zure erakundeko gakoen zerrenda ikusiko duzu (aktiboak eta baliogabetuak) eta «Nola konektatu» txartel bat, oinarrizko URLarekin eta adibide batekin.
Sakatu «Gako berria»
Jarri integrazioa identifikatzen duen izen bat («Dendako CRMa», «Make», «n8n»). Horrela, egunen batean baliogabetu behar baduzu, zein den jakingo duzu.
Aukeratu baimenak
Markatu integrazioak behar dituen baliabideak —Bezeroak, Hornitzaileak edo biak— eta horietako bakoitzerako aukeratu «Irakurtzeko soilik» (kontsultatu) edo «Irakurri eta idatzi» (kontsultatu, sortu, eguneratu eta artxibatu). Markatu gabeko baliabidea gakoa iristen ez den baliabidea da. Aukeratu behar duen gutxienekoa.
Kopiatu gakoa eta gorde zure tresnan
Gako osoa (sat_ aurrizkiarekin hasten da) behin bakarrik erakusten da. Kopiatu botoiarekin eta itsatsi Maken, n8n-n edo zure CRMan. Galtzen baduzu, ezin da berreskuratu: baliogabetu eta beste bat sortu behar da.
Ezarpenak → API: gakoen zerrenda eta sortu berri den gakoa
CRM Make
sat_Ab3k…x9Zq
n8n
sat_Qm7t…p2Lk
Gakoa sortu da
sat_Ab3k9Zq2Xv8Lp1Mn4Rt7Wy0Cd5Fg6Hj3Kl8Sx9ZqKopiatuGako osoa ikusiko duzun aldi bakarra da hau. Galtzen baduzu, baliogabetu eta sortu beste bat.
Gako baten baimenak
Irakurtzeko soilik
Baliabide hori zerrendatu eta kontsulta dezake. Sortzeko, aldatzeko edo artxibatzeko edozein saiakerak 403 errorea jasotzen du, PERMISO_DENEGADO kodearekin eta falta zaion baimenarekin.
Irakurri eta idatzi
Kontsultatzeaz gain, baliabide horretan sortu, eguneratu eta artxibatu dezake. Norabide biko sinkronizazio batek behar duen baimena da.
Baimenak baliabideko dira
Baimenak baliabideko dira, eta hori nabaritu da jada: hornitzaileak gehitzean, lehendik zeuden gakoek —guztiak bezeroetarakoak— EZ zuten haietarako sarbiderik lortu. Markatu egin behar izan zen. Gauza bera gertatuko da geroago gehitzen den edozein baliabiderekin: integrazio batek ez du inoiz eman zeniona baino gehiago ikusten.
Nola autentifikatu
Bidali gakoa eskaera bakoitzean, zerbitzaritik zerbitzarira, Authorization: Bearer sat_… goiburuan. Zure tresnak baimen-goibururik onartzen ez badu, x-api-key goiburuan ere onartzen da. Oinarrizko URLa zure Sattotalena da, /api/v1 atzetik duela (Ezarpenak → API pantailan kopiatuta duzu).
GET /api/v1/me Authorization: Bearer sat_Ab3k9…x9Zq
APIak nahita ez du CORSik: zerbitzarietarako eta automatizazio-tresnetarako pentsatuta dago, ez zure bezeroen nabigatzailean exekutatzen diren web-orri edo aplikazioetarako. Gako batek ez luke inoiz nabigatzaile batera iritsi behar.
Zer egin daitekeen (endpointak)
Erantzun guztiek success + data forma dute (eta pagination zerrendetan). Bezero bat bere id-aren edo kodearen (CLI-0007) bidez eska dezakezu; hornitzaile bat, id-aren bidez soilik.
| Metodoa | Bidea | Zer egiten duen | Baimena |
|---|---|---|---|
| GET | /me | Zure erakundea eta deitzeko erabiltzen duzun gakoa itzultzen ditu. Erabili Maken edo n8n-n «konexioa probatzeko». | Edozein |
| GET | /clientes | Bezeroen zerrenda orrikatua. Iragazkiak: busqueda, tipo, activo eta actualizadoDesde. activo gabe, artxibatuak ere itzultzen ditu. | Irakurtzea |
| POST | /clientes | Bezero bat sortzen du inprimakiaren arau berberekin (identifikatzaile fiskala zure herrialdearen arabera, IFZ edo email bikoizturik gabe). | Idaztea |
| GET | /clientes/{id} | Bezero bat itzultzen du id-aren edo kodearen bidez. | Irakurtzea |
| PATCH | /clientes/{id} | Bidalitako eremuak soilik eguneratzen ditu. PUT sinonimo gisa onartzen da. | Idaztea |
| DELETE | /clientes/{id} | Bezeroa artxibatzen du (activo = false). Ez du ezer ezabatzen eta errorerik gabe errepika daiteke. | Idaztea |
| GET | /proveedores | Hornitzaileen zerrenda orrikatua. Iragazkiak: busqueda, activo, tipoProveedor, codigo eta actualizadoDesde. activo gabe, artxibatuak ere itzultzen ditu. | Irakurtzea |
| POST | /proveedores | Hornitzaile bat sortzen du. Izena soilik da derrigorrezkoa. Identifikatzaile fiskal bera edo izen bera duen bat badago, 409 erantzuten du lehendik dagoenaren id-arekin. | Idaztea |
| GET | /proveedores/{id} | Hornitzaile bat itzultzen du bere id-aren bidez. Hemen kodeak EZ du balio: ikusi beherago dagoen oharra. | Irakurtzea |
| PATCH | /proveedores/{id} | Bidalitako eremuak soilik eguneratzen ditu. Kontaktuen zerrenda osorik ordezkatzen da. PUT sinonimo gisa onartzen da. | Idaztea |
| DELETE | /proveedores/{id} | Hornitzailea artxibatzen du (activo = false). Ez du ezer ezabatzen eta errorerik gabe errepika daiteke. | Idaztea |
| GET | /reparaciones | Fitxen zerrenda orrikatua, sarrera berrienetik zaharrenera. Iragazkiak: cliente, estado, entradaDesde, entradaHasta eta actualizadoDesde. | Irakurtzea |
| GET | /reparaciones/{id} | Fitxa bat itzultzen du bere id-aren edo fitxa-zenbakiaren bidez. | Irakurtzea |
| GET | /clientes/{id}/reparaciones | Bezero baten fitxak (bere id-aren edo kodearen bidez), iragazki berberekin. | Irakurtzea |
| GET | /clientes/{id}/resumen | Bezeroaren jardueraren laburpena: zenbat konponketa dituen (guztira, irekiak eta egoeraka), zenbat aurrekontatu zaion eta azken aldiz noiz etorri zen. | Irakurtzea |
Bezeroaren eremuak
Eremuak bezeroaren fitxakoak berberak dira: nombre eta tipo (particular edo empresa) derrigorrezkoak dira; nif_cif, apellidos, razonSocial, email, telefono, telefonoSecundario, direccion (calle, numero, piso, codigoPostal, localidad, provincia, pais) eta notas aukerakoak dira. Identifikatzaile fiskala letra larriz gordetzen da eta emaila letra xehez. Erantzunean gako guztiak beti daude, null balioarekin baliorik ez dagoenean, zure tresnako eremuen mapaketa hauts ez dadin. Kontuz izenarekin: nombre izena da (edo izen komertziala enpresa bada), eta abizena aparte doa, apellidos eremuan, pluralean.
APIak ezagutzen ez dituen eremuak
Gorputzak existitzen ez den gako bat badakar (adibidez, firstName nombre-ren ordez, edo apellido singularrean apellidos-en ordez), eskaera ez da baztertzen, baina datu hori ez da gordetzen. Oharkabean pasa ez dadin, bezeroen alta- eta edizio-erantzunak avisos.camposIgnorados dakar, gako horien zerrendarekin; helbidekoek beren bidea daramate, direccion.ciudad bezala. Agertzen bazaizu, berrikusi zure integrazioaren eremuen mapaketa. APIak berak itzultzen dituen eremuek (id, codigo, createdAt…) ez dute abisurik sortzen; beraz, bezero bat irakurri, aldatu eta oso-osorik itzul dezakezu.
POST /api/v1/clientes
{ "firstName": "Daniel", "nombre": "Florea", "tipo": "particular" }
201 Created
{
"success": true,
"data": { "nombre": "Florea", "apellidos": null, … },
"avisos": { "camposIgnorados": ["firstName"] }
}Adibidea: bezero bat sortu
Eskaera
POST /api/v1/clientes
Authorization: Bearer sat_Ab3k9…x9Zq
Content-Type: application/json
{
"nombre": "Daniel",
"apellidos": "Florea",
"tipo": "empresa",
"razonSocial": "Assista Tech SRL",
"nif_cif": "RO12345678",
"codigoPersonalizado": "801",
"email": "daniel@example.com",
"telefono": "+40 700 000 000",
"direccion": { "localidad": "București", "pais": "RO" }
}Erantzuna (201)
{
"success": true,
"data": {
"id": "64b0…0001",
"codigo": "CLI-0042",
"codigoPersonalizado": "801",
"codigoVisible": "801",
"tipo": "empresa",
"nombre": "Daniel",
"apellidos": "Florea",
"razonSocial": "Assista Tech SRL",
"nif_cif": "RO12345678",
"email": "daniel@example.com",
"activo": true,
"createdAt": "2026-09-18T10:00:00.000Z",
"updatedAt": "2026-09-18T10:00:00.000Z"
}
}Hornitzaileak
Bezeroez gain, APIak hornitzaileen katalogoa erakusten du: bost endpoint berak, errore-kode berak eta sinkronizazio inkremental bera. Katalogoa besterik ez da: erosketak eta hornitzaileen fakturak lehen zeuden lekuan geratzen dira, zure ERPan edo Sattotalen.
Hornitzailearen eremuak
nombre soilik da derrigorrezkoa. Aukerakoak: codigo, cif, email, telefono, telefonoSecundario, web, direccion (lerro bakarrean, ez da objektu bat bezeroetan bezala), ciudad, provincia, codigoPostal, pais, contactos, tipoProveedor (general, producto, servicio, logistica edo otro), formaPago, plazoPago (egunetan; 0 eskudirutan da), cuentaCliente eta notas. Kontaktu bakoitzak nombre —derrigorrezkoa—, cargo, telefono, email eta notas daramatza; kontaktuek ez dute identifikatzaile propiorik.
Kontaktuak nola eguneratzen diren
Bidaltzen duzun zerrendak zegoena ORDEZKATZEN du. Zerrenda huts bat bidaltzen baduzu, kontaktu guztiak ezabatzen dira; gakoa bidaltzen ez baduzu (edo null bidaltzen baduzu), zeuden bezala geratzen dira. Horri esker, hornitzaile bat irakurri, eremu bat aldatu eta oso-osorik itzul dezakezu ondorio arraroik gabe.
Eskaera
POST /api/v1/proveedores
Authorization: Bearer sat_Ab3k9…x9Zq
Content-Type: application/json
{
"nombre": "Distribuciones Norte",
"cif": "B12345678",
"tipoProveedor": "producto",
"plazoPago": 30,
"cuentaCliente": "C-4471",
"contactos": [
{ "nombre": "Ana Ruiz", "cargo": "Ventas", "email": "ana@norte.es" }
]
}Erantzuna (201)
{
"success": true,
"data": {
"id": "64b0…0009",
"codigo": "PROV-004",
"nombre": "Distribuciones Norte",
"cif": "B12345678",
"tipoProveedor": "producto",
"plazoPago": 30,
"cuentaCliente": "C-4471",
"contactos": [
{ "nombre": "Ana Ruiz", "cargo": "Ventas",
"telefono": null, "email": "ana@norte.es", "notas": null }
],
"excluidoRecargoEquivalencia": false,
"activo": true,
"createdAt": "2026-09-19T08:00:00.000Z",
"updatedAt": "2026-09-19T08:00:00.000Z"
}
}Banku-datuak ez dira APIaren bidez ateratzen
Hornitzailearen IBANa eta banku-kontuak ez dira itzultzen ez onartzen, nahita: gako bat filtratuko balitz, ez luke balioko kontu-aldaketaren iruzurrerako, hornitzaileekin ohikoena dena. cuentaCliente bai ateratzen da: hornitzaile horretan ZURE bezero-zenbakia da, eta horrekin bateratzen ditu ERP batek bere erosketak.
Baliokidetasun-errekargua irakurtzeko soilik da
excluidoRecargoEquivalencia eremua itzultzen da eta balio berarekin berriro bidal dezakezu (objektu osoa itzuli ahal izateko), baina APIaren bidez aldatzeak 400 erantzuten du: hornitzaile horri egiten dizkiozun erosketei errekargua aplikatzen zaien erabakitzen du, hau da, zure erosketa-fakturen zerga-oinarria aldatzen du. Hornitzailearen fitxatik aldatzen da. Espainiatik kanpo ez du inolako eraginik.
Hornitzaile-kodeak ez du aurkitzeko balio
Bezeroarenak ez bezala, hornitzailearen kodea (PROV-004) ez da bakarra: errepika daiteke zure tailerraren barruan ere. Horregatik, GET /proveedores/{id} bideak id-a soilik onartzen du. Zure ERPak kodea bakarrik gordetzen badu, erabili zerrendaren iragazkia: GET /proveedores?codigo=PROV-004; bat datozen guztiak itzultzen ditu, eta zuk erabakitzen duzu.
Konponketa-fitxak (irakurtzeko soilik)
APIak konponketa-fitxak kontsultatzeko aukera ere ematen du: fitxa-zenbakia, egoera, datak, gailua (mota, marka, modeloa, serie-zenbakia, IMEIa) eta aurrekontua. Irakurtzeko soilik da: fitxak Sattotaletik sortzen eta egoeraz aldatzen jarraitzen dira, han sinatzen baitira gordailu-agiria eta entrega. Gakoak Konponketak baliabidea markatuta izan behar du; bezeroen edo hornitzaileen gakoak ez dira haietara iristen.
Fitxaren eremuak
Fitxa bakoitzak numeroFicha, estado, prioridad, ubicacion, averiaDeclarada, diagnostico dakartza, zikloaren datak (sarrera, diagnostikoaren eta konponketaren hasiera eta amaiera, bezeroari abisua, entrega eta ultimoCambioEstado, uneko egoerara noiz pasatu zen), bezeroaren laburpen bat (id, codigo, codigoVisible, nombre, apellidos, razonSocial), gailua (id, codigo, tipo, marca, modelo, numeroSerie, imei, color), aurrekontua (numero, total, estado, fechaEnvio eta fechaRespuesta, edo null ez badu), esleitutako teknikaria (izena soilik) eta plazoEntregaEstimado, gordailu-agirian bezeroari adierazitako epea. Ez dira inoiz ateratzen barne-oharrak, sinadurak, argazkiak, dokumentuak ez gailuaren pasahitzak.
Eskaera
GET /api/v1/clientes/CLI-0042/reparaciones?estado=reparado Authorization: Bearer sat_Ab3k9…x9Zq
Erantzuna (201)
{
"success": true,
"data": [{
"id": "64b0…0042",
"numeroFicha": "ORD-2026-0042",
"estado": "reparado",
"prioridad": "normal",
"averiaDeclarada": "No carga",
"diagnostico": "Conector de carga dañado",
"fechas": {
"entrada": "2026-09-20T09:00:00.000Z",
"finReparacion": "2026-09-22T17:30:00.000Z",
"entrega": null
},
"cliente": { "id": "64b0…0001", "codigoVisible": "801", "nombre": "Daniel" },
"dispositivo": {
"tipo": "movil", "marca": "Apple", "modelo": "iPhone 13",
"numeroSerie": "F2LXX0000", "imei": "356789012345678"
},
"presupuesto": { "numero": "PRES-2026-0010", "total": 89.9, "estado": "aprobado" },
"tecnico": { "nombre": "Andrei Popescu" },
"plazoEntregaEstimado": "3 días laborables"
}],
"pagination": { "total": 1, "page": 1, "limit": 25, "totalPages": 1 }
}Bezeroa deitzen duen telefonoaren bidez aurkitu
Zure CRMak edo zure telefono-zentralak bezeroaren fitxa irekitzen badu dei bat sartzean, erabili GET /clientes?telefono=<telefono zenbakia>. Telefono nagusian eta bigarrenean bilatzen du, eta ez dio axola nola dagoen idatzita: zuriuneak, marratxoak, zure herrialdeko nazioarteko aurrizkia (+34 edo 0034) eta hasierako 0a. Horrela, «612 345 678» bilatuta, «+34 612-345-678» gisa gordetako bezeroa aurkitzen da. Gutxienez 6 digitu behar dira.
Bezeroaren laburpena zure CRMrako
GET /clientes/{id}/resumen bideak dei bakar batean itzultzen du CRM batek bezeroaren fitxan erakutsi ohi duena: totalReparaciones, reparacionesAbiertas (gailua tailerrean dago oraindik), porEstado, totalPresupuestado eta totalPresupuestosAprobados (tailerraren txanponean, moneda eremuan iristen dena), primeraReparacion, ultimaReparacion eta ultimaActividad (bere fitxetako edozeinetan izandako azken aldaketa). Konponketak baliabidea behar du, fitxek bezala.
Eskaera
GET /api/v1/clientes?telefono=0722 123 456
→ { "data": [{ "id": "64b0…0001", "codigoVisible": "801", "telefono": "+40 722 123 456", … }] }
GET /api/v1/clientes/801/resumen
{
"success": true,
"data": {
"cliente": { "id": "64b0…0001", "codigoVisible": "801" },
"moneda": "RON",
"totalReparaciones": 7,
"reparacionesAbiertas": 1,
"porEstado": { "entregado": 6, "en_reparacion": 1 },
"totalPresupuestosAprobados": 1240.5,
"ultimaReparacion": "2026-10-02T09:15:00.000Z",
"ultimaActividad": "2026-10-06T16:40:00.000Z",
…
}
}Aldatu dena soilik sinkronizatu
Ez da beharrezkoa exekuzio bakoitzean dena ekartzea. Gorde zure tresnan azken exekuzioaren data eta ordua, eta eskatu ordutik aldatutako bezeroak edo hornitzaileak soilik actualizadoDesde parametroarekin. Erantzuna aldaketa-dataren arabera goranzko ordenan dator, berdinketa egonkor batekin; beraz, orrika dezakezu erregistrorik saltatu gabe. Artxibatuak ere agertzen dira (activo = false balioarekin), zure CRMak artxibatzea isla dezan.
GET /api/v1/clientes?actualizadoDesde=2026-09-18T10:00:00Z&limit=100&page=1 Authorization: Bearer sat_Ab3k9…x9Zq
Lehen exekuzioa
Zeharkatu GET /clientes limit=100 eta page=1, 2, 3… balioekin, totalPages amaitu arte. Gorde hasiera-ordua.
Hurrengo exekuzioak
Eskatu GET /clientes?actualizadoDesde=<gordetako ordua> eta prozesatu iristen dena soilik. Gorde berriro exekuzio honen hasiera-ordua.
Lotu, ez bikoiztu
Gorde Sattotalen id-a zure CRMko erregistroarekin batera. Sortzean 409 DUPLICADO jasotzen baduzu, erantzunak existenteId dakar: lotu hori, beste bat sortu beharrean.
Orrikatzea eta bilaketa
Zerrendek page (1etik aurrera) eta limit (25 lehenespenez, 100 gehienez; gehiago eskatzen baduzu, 100era mozten da) onartzen dituzte. busqueda eremuak izenean, abizenetan, sozietate-izenean, identifikatzaile fiskalean, emailean, kodean eta telefonoan bilatzen du.
Errore-kodeak eta zer egin
Errore-erantzun guztiek success: false daramate, testu orientagarri bat eta code egonkor bat, programaz erabakitzeko pentsatua. Hauek dira jaso ditzakezunak:
NO_AUTORIZADOGakoa falta da, ez da gure formatukoa edo ez da existitzen. Berrikusi Authorization goiburua.
CLAVE_REVOCADAGakoa baliozkoa zen, baina administratzaile batek baliogabetu zuen. Sortu berri bat Ezarpenak → API atalean eta eguneratu zure tresnan.
PLAN_REQUERIDOErakundea doako planean dago. APIak berriro funtzionatzen du ordainpeko plan batera aldatzean.
PERMISO_DENEGADOGakoak ez du eragiketa horretarako behar den baimena. Erantzunak ambitoRequerido eremuan adierazten du zein falta den: sortu baimen hori duen gako bat.
NO_ENCONTRADOZure erakundean ez dago id hori duen bezero edo hornitzailerik. Beste erakunde batzuetakoak ez dira inoiz ikusgai, eta ez da bereizten «ez da existitzen» eta «ez da zurea».
DUPLICADOBadago datu hori duen erregistro bat: identifikatzaile fiskala edo emaila bezeroetan; identifikatzaile fiskala, izena edo kodea hornitzaileetan. Erantzunak campo eta existenteId dakartza, beste bat sortu beharrean lotu ahal izan dezazun.
VALIDACIONEremuren batek ez du baliozkotzea gainditzen (edo JSONa gaizki osatuta dago). details eremuan eremua eta arrazoia doaz, inprimakian bezala.
IDENTIFICADOR_FISCAL_REQUERIDOBezero horrek identifikatzaile fiskala behar du: zure herrialdean derrigorrezkoa da bidalitako bezero motarentzat (adibidez, enpresentzat beti).
RATE_LIMITEskaera gehiegi. Itxaron Retry-After goiburuak adierazten dituen segundoak eta saiatu berriro.
API_DESACTIVADAAPIa aldi baterako desaktibatuta dago mantentze-lanengatik. Saiatu berriro geroago.
Mugak
120 eskaera minutuko eta gakoko (nahikoa eta gehiago sinkronizazio periodiko baterako; nahi gabeko begizta bat geldiarazten du). 10 gako aktibo erakunde bakoitzeko. Zerrendek gehienez 100 erregistro itzultzen dituzte orriko. Erakundea doako planean badago eta hileko kuota agortuta badu, bezeroen alta aplikazioan bezala mozten da.
Urratsez urrats: bezeroak Makekin sinkronizatu
Eszenatoki ohikoa: 15 minuturo, Sattotalen berriak edo aldatuak diren bezeroak eta hornitzaileak zure CRMra ekartzea. n8n-n baliokidea da HTTP Request nodoarekin eta Schedule nodo batekin.
Sortu gakoa Sattotalen
Ezarpenak → API → Gako berria, «Irakurtzeko soilik» baimena irakurri besterik egingo ez baduzu, «Irakurri eta idatzi» CRMtik bezeroak ere sortuko badituzu. Kopiatu gakoa.
«Make a request» HTTP modulua
URLa: zure oinarrizko URLa + /clientes. GET metodoa. Authorization goiburua, Bearer eta zure gakoa balio gisa. Markatu «Parse response» JSONarekin lan egiteko.
Probatu konexioa
Ezer baino lehen, exekutatu behin /me helbidera eskaera bat: zure erakundea eta gakoaren izena itzultzen baditu, autentifikazioa ondo dago.
Gehitu iragazki inkrementala
Gorde azken exekuzioaren data Data store batean edo aldagai batean, eta pasa ezazu actualizadoDesde gisa URLan. Programatu eszenatokia 15 minuturo.
Mapatu eremuak zure CRMrantz
Iteratu data[] eta mapatu id, codigo, nombre, apellidos, email, telefono, nif_cif eta direccion. Gorde Sattotalen id-a zure CRMan, bikoiztu beharrean eguneratzeko.
CRMtik bezeroak sortzeko, beste HTTP modulu bat POST metodoarekin /clientes helbidera eta bezeroaren JSON gorputzarekin. 409 jasotzen baduzu, erabili existenteId lotzeko.
Segurtasuneko jardunbide egokiak
Gako bat integrazio bakoitzeko
Horrela, bat baliogabe dezakezu besteak hautsi gabe, eta zerrendan ikusten duzu bakoitza azkeneko aldiz noiz erabili zen.
Inoiz ez nabigatzailean ez biltegi publiko batean
Gorde zure tresnaren kredentzialen biltegian (Maken konexioak, n8n-ren kredentzialak, ingurune-aldagaiak). Biltegi batera edo web batera igotzen baduzu, jo ezazu filtratutzat.
Filtratzen bada, baliogabetu eta sortu beste bat
Baliogabetzea berehalakoa da: gako zaharrak 401 CLAVE_REVOCADA jasotzen hasten da. Eguneratu berria zure tresnan, eta kitto.
API zehaztapena
Erreferentzia tekniko osoa (bideak, parametroak, eskemak eta errore-kodeak) formatu irekian argitaratuta dago /api/v1/openapi.json helbidean, gakorik behar gabe. Besterik gabe gaztelaniaz ateratzen da; gehitu ?lang= zure hizkuntzarekin itzulita izateko (adibidez /api/v1/openapi.json?lang=en edo ?lang=ro). Postmanen, Insomnian, Maken edo n8n-n inporta dezakezu, dei guztiak prest izateko.
Ohiko galderak
Gakoa galdu dut; berriro ikus dezaket?
Ez. Sortzean bakarrik erakusten da, eta gero modu itzulezinean gordetzen da. Baliogabetu Ezarpenak → API atalean eta sortu beste bat.
Ba al dago webhookik, zerbait aldatzen denean Sattotalek nire CRMari abisa diezaion?
Oraindik ez. Gomendatutako modua actualizadoDesde parametroarekin aldizka kontsultatzea da, aldatu dena soilik itzultzen baitu.
Zer datu erakusten ditu APIak?
Bezeroak eta hornitzaileak: zerrendatu, sortu, kontsultatu, eguneratu eta artxibatu. Baimenak baliabideko dira; beraz, hornitzaileak existitu aurretik sortutako gako batek ez du haietarako sarbiderik administratzaile batek markatu arte. Gainera, konponketa-fitxak irakurtzeko soilik (egoera, datak, gailua eta aurrekontua), beren baimenarekin.
Bezero bat ezaba dezaket APIaren bidez?
Ez, artxibatu soilik (activo = false), aplikazioan bezala. Bezeroentzat zein hornitzaileentzat balio du. Artxibatutako erregistro batek sinkronizazioan agertzen jarraitzen du, zure CRMak isla dezan.
APIa doako planean dago?
Ez. Basic, Pro eta Enterprise planetan eta proba-aldian dago barne. Doako planean, sortu zenituen gakoak ikusten eta baliogabetzen jarrai dezakezu.
Bezeroaren abizena bakarrik iristen zait; zergatik ez da izena gordetzen?
Ia beti eremuen mapaketa da: izenak nombre eremuan joan behar du eta abizenak apellidos eremuan. Zure tresnak izena beste gako batekin bidaltzen badu (firstName, name, apellido…), APIak baztertu egiten du eta erantzuneko avisos.camposIgnorados eremuan adierazten dizu. Zuzendu mapaketa eta bidali berriro bezeroa PATCH batekin.
Deitzen ari zaidan zenbakiarekin bezeroa aurki dezaket?
Bai. Eskatu GET /api/v1/clientes?telefono= zenbakia iristen zaizun bezala: berdin dio nazioarteko aurrizkia, zuriuneak edo marratxoak baditu, eta bigarren telefonoan ere bilatzen du. Haren id-arekin, ondoren bere fitxak (/clientes/{id}/reparaciones) eta laburpena (/clientes/{id}/resumen) eska ditzakezu.