API un integrācijas (CRM, Make, n8n)
Savienojiet savu CRM vai ERP ar Sattotal, izmantojot API atslēgas: sinhronizējiet klientus un piegādātājus automātiski un droši
Sattotal API ļauj citai programmai — jūsu CRM, ERP, Make, n8n, Zapier vai pašu veidotam skriptam — lasīt un veidot klientus un piegādātājus jūsu organizācijā, un nevienam nav manuāli jāimportē CSV. Piekļuvi kontrolē API atslēgas, ko administrators izveido sadaļā Iestatījumi → API; katrai ir savs nosaukums un atļaujas pa resursiem, un tās var jebkurā brīdī atsaukt. Šeit uzzināsiet, ko API dara, kā izveidot atslēgu, kā izsaukt API un kā soli pa solim izveidot sinhronizāciju ar Make.
Savienojiet savu CRM un automatizācijas
Jebkurš rīks, kas spēj nosūtīt HTTP pieprasījumu (Make, n8n, Zapier, jūsu CRM vai ERP), var lasīt, veidot un atjaunināt klientus un piegādātājus.
Atslēgas ar nosaukumu un atļaujām
Viena atslēga katrai integrācijai, un katrā atslēgā atļauja katram resursam: varat dot piegādātāju lasīšanas tiesības, nedodot klientu rakstīšanas tiesības. Līdz 10 aktīvām atslēgām vienā organizācijā.
Inkrementāla sinhronizācija
Ar parametru actualizadoDesde tiek ielādēti tikai tie klienti vai piegādātāji, kas mainījušies kopš pēdējās reizes: ideāli scenārijam, kas darbojas ik pēc dažām minūtēm.
Droša pēc konstrukcijas
Atslēga tiek parādīta tikai vienu reizi un saglabāta neatgriezeniski šifrētā veidā. Katra atslēga piekļūst tikai savas organizācijas datiem, un to var atsaukt acumirklī.
Kas to var izmantot
Atslēgas izveido un atsauc organizācijas administratori. API ir iekļauta maksas plānos (Basic, Pro un Enterprise) un izmēģinājuma periodā; bezmaksas plānā ekrānā redzama slēdzene ar iespēju mainīt plānu. Atslēga vienmēr darbojas organizācijas, nevis konkrētas personas vārdā: tā nepārmanto neviena tehniķa atļaujas un neparādās komandā kā lietotājs.
Kā izveidot atslēgu
Atveriet Iestatījumi → API
Sānu izvēlnē — Iestatījumi, kartīte «API». Redzēsiet savas organizācijas atslēgu sarakstu (aktīvās un atsauktās) un kartīti «Kā pieslēgties» ar bāzes URL un piemēru.
Noklikšķiniet uz «Jauna atslēga»
Piešķiriet tai nosaukumu, kas identificē integrāciju («Veikala CRM», «Make», «n8n»). Tā, ja kādreiz būs jāatsauc, zināsiet, kura tā ir.
Izvēlieties atļaujas
Atzīmējiet resursus, kas integrācijai vajadzīgi — Klienti, Piegādātāji vai abi —, un katram izvēlieties «Tikai lasīšana» (skatīt) vai «Lasīšana un rakstīšana» (skatīt, veidot, atjaunināt un arhivēt). Neatzīmēts resurss atslēgai nav pieejams. Izvēlieties minimumu, kas nepieciešams.
Nokopējiet atslēgu un saglabājiet to savā rīkā
Pilnā atslēga (sākas ar sat_) tiek parādīta tikai vienu reizi. Nokopējiet to ar pogu un ielīmējiet Make, n8n vai savā CRM. Ja to pazaudēsiet, atgūt to nevar: tā jāatsauc un jāizveido jauna.
Iestatījumi → API: atslēgu saraksts un tikko izveidota atslēga
CRM Make
sat_Ab3k…x9Zq
n8n
sat_Qm7t…p2Lk
Atslēga izveidota
sat_Ab3k9Zq2Xv8Lp1Mn4Rt7Wy0Cd5Fg6Hj3Kl8Sx9ZqKopētŠī ir vienīgā reize, kad redzēsiet pilnu atslēgu. Ja to pazaudēsiet, atsauciet to un izveidojiet jaunu.
Atslēgas atļaujas
Tikai lasīšana
Var uzskaitīt un skatīt attiecīgo resursu. Jebkurš mēģinājums veidot, mainīt vai arhivēt saņem kļūdu 403 ar kodu PERMISO_DENEGADO un trūkstošo atļauju.
Lasīšana un rakstīšana
Papildus skatīšanai var veidot, atjaunināt un arhivēt attiecīgajā resursā. Šī atļauja nepieciešama divvirzienu sinhronizācijai.
Atļaujas tiek piešķirtas pa resursiem
Atļaujas tiek piešķirtas katram resursam atsevišķi, un tas jau ir bijis jūtams: kad tika pievienoti piegādātāji, esošās atslēgas — visas klientu atslēgas — NEieguva piekļuvi tiem. Tā bija jāatzīmē. Tas pats attieksies uz jebkuru vēlāk pievienotu resursu: integrācija nekad neredz vairāk, nekā jūs tai atļāvāt.
Kā autentificēties
Sūtiet atslēgu katrā pieprasījumā no servera uz serveri galvenē Authorization: Bearer sat_…. Ja jūsu rīks neatbalsta autorizācijas galvenes, to var nosūtīt arī galvenē x-api-key. Bāzes URL ir jūsu Sattotal adrese ar /api/v1 galā (tā ir nokopēta ekrānā Iestatījumi → API).
GET /api/v1/me Authorization: Bearer sat_Ab3k9…x9Zq
API apzināti neatbalsta CORS: tā paredzēta serveriem un automatizācijas rīkiem, nevis tīmekļa lapām vai lietotnēm, kas darbojas jūsu klientu pārlūkprogrammā. Atslēga nekad nedrīkst nonākt pārlūkprogrammā.
Ko var darīt (galapunkti)
Visām atbildēm ir forma success + data (un sarakstos arī pagination). Klientu var pieprasīt pēc tā id vai koda (CLI-0007); piegādātāju — tikai pēc id.
| Metode | Ceļš | Ko dara | Atļauja |
|---|---|---|---|
| GET | /me | Atgriež jūsu organizāciju un atslēgu, ar kuru veicat izsaukumu. Izmantojiet to, lai «pārbaudītu savienojumu» Make vai n8n. | Jebkura |
| GET | /clientes | Klientu saraksts pa lapām. Filtri: busqueda, tipo, activo un actualizadoDesde. Bez activo tiek atgriezti arī arhivētie. | Lasīšana |
| POST | /clientes | Izveido klientu pēc tiem pašiem noteikumiem kā veidlapā (nodokļu identifikators atbilstoši jūsu valstij, bez NIF vai e-pasta dublikātiem). | Rakstīšana |
| GET | /clientes/{id} | Atgriež klientu pēc id vai koda. | Lasīšana |
| PATCH | /clientes/{id} | Atjaunina tikai nosūtītos laukus. PUT tiek pieņemts kā sinonīms. | Rakstīšana |
| DELETE | /clientes/{id} | Arhivē klientu (activo = false). Neko neizdzēš, un to var atkārtot bez kļūdas. | Rakstīšana |
| GET | /proveedores | Piegādātāju saraksts pa lapām. Filtri: busqueda, activo, tipoProveedor, codigo un actualizadoDesde. Bez activo tiek atgriezti arī arhivētie. | Lasīšana |
| POST | /proveedores | Izveido piegādātāju. Obligāts ir tikai nosaukums. Ja jau ir kāds ar tādu pašu nodokļu identifikatoru vai nosaukumu, atbilde ir 409 ar esošā id. | Rakstīšana |
| GET | /proveedores/{id} | Atgriež piegādātāju pēc tā id. Šeit kods NEDER: skatiet piezīmi zemāk. | Lasīšana |
| PATCH | /proveedores/{id} | Atjaunina tikai nosūtītos laukus. Kontaktpersonu saraksts tiek aizstāts pilnībā. PUT tiek pieņemts kā sinonīms. | Rakstīšana |
| DELETE | /proveedores/{id} | Arhivē piegādātāju (activo = false). Neko neizdzēš, un to var atkārtot bez kļūdas. | Rakstīšana |
| GET | /reparaciones | Remonta pasūtījumu saraksts pa lapām, no jaunākās pieņemšanas līdz vecākajai. Filtri: cliente, estado, entradaDesde, entradaHasta un actualizadoDesde. | Lasīšana |
| GET | /reparaciones/{id} | Atgriež pasūtījumu pēc tā id vai pasūtījuma numura. | Lasīšana |
| GET | /clientes/{id}/reparaciones | Klienta remonta pasūtījumi (pēc klienta id vai koda) ar tiem pašiem filtriem. | Lasīšana |
| GET | /clientes/{id}/resumen | Klienta aktivitātes kopsavilkums: cik remontu viņam ir (kopā, atvērti un pa statusiem), par kādu summu sagatavotas tāmes un kad viņš pēdējoreiz bija servisā. | Lasīšana |
Klienta lauki
Lauki ir tādi paši kā klienta kartītē: nombre un tipo (particular vai empresa) ir obligāti; nif_cif, apellidos, razonSocial, email, telefono, telefonoSecundario, direccion (calle, numero, piso, codigoPostal, localidad, provincia, pais) un notas nav obligāti. Nodokļu identifikators tiek saglabāts ar lielajiem burtiem, e-pasts — ar mazajiem. Atbildē visas atslēgas ir vienmēr klāt, ar null, ja vērtības nav, lai lauku kartēšana jūsu rīkā nesabojātos. Uzmanieties ar vārdu: nombre ir vārds (vai uzņēmuma komercnosaukums), bet uzvārds tiek norādīts atsevišķi laukā apellidos, daudzskaitlī.
Lauki, ko API neatpazīst
Ja pieprasījuma ķermenī ir atslēga, kas neeksistē (piemēram, firstName nevis nombre vai apellido vienskaitlī nevis apellidos), pieprasījums netiek noraidīts, taču šie dati netiek saglabāti. Lai tas nepaliktu nepamanīts, klienta izveides un rediģēšanas atbildē ir avisos.camposIgnorados ar šo atslēgu sarakstu; adreses atslēgām norādīts to ceļš, piemēram, direccion.ciudad. Ja tas parādās, pārbaudiet savas integrācijas lauku kartēšanu. Lauki, ko atgriež pati API (id, codigo, createdAt…), brīdinājumu neizraisa, tāpēc varat nolasīt klientu, to mainīt un nosūtīt atpakaļ pilnībā.
POST /api/v1/clientes
{ "firstName": "Daniel", "nombre": "Florea", "tipo": "particular" }
201 Created
{
"success": true,
"data": { "nombre": "Florea", "apellidos": null, … },
"avisos": { "camposIgnorados": ["firstName"] }
}Piemērs: klienta izveide
Pieprasījums
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" }
}Atbilde (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"
}
}Piegādātāji
Papildus klientiem API atklāj arī piegādātāju katalogu: tie paši pieci galapunkti, tie paši kļūdu kodi un tā pati inkrementālā sinhronizācija. Tas ir tikai katalogs: iepirkumi un piegādātāju rēķini paliek tur, kur tie jau ir — jūsu ERP vai Sattotal.
Piegādātāja lauki
Obligāts ir tikai nombre. Neobligāti: codigo, cif, email, telefono, telefonoSecundario, web, direccion (vienā rindā, nevis objekts kā klientiem), ciudad, provincia, codigoPostal, pais, contactos, tipoProveedor (general, producto, servicio, logistica vai otro), formaPago, plazoPago (dienās; 0 nozīmē skaidrā naudā uzreiz), cuentaCliente un notas. Katrai kontaktpersonai ir nombre — obligāts —, cargo, telefono, email un notas; kontaktpersonām nav sava identifikatora.
Kā tiek atjauninātas kontaktpersonas
Nosūtītais saraksts AIZSTĀJ iepriekšējo. Ja nosūtāt tukšu sarakstu, visas kontaktpersonas tiek izdzēstas; ja atslēgu nenosūtāt (vai nosūtāt null), tās paliek kā bija. Tādēļ varat nolasīt piegādātāju, mainīt vienu lauku un nosūtīt to atpakaļ pilnībā bez dīvainām blaknēm.
Pieprasījums
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" }
]
}Atbilde (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"
}
}Bankas dati caur API netiek izsniegti
Piegādātāja IBAN un bankas konti apzināti netiek ne atgriezti, ne pieņemti: ja atslēga nopludinātu, to nevarētu izmantot konta maiņas krāpšanai, kas ir visizplatītākā krāpšana ar piegādātājiem. Tiek izsniegts cuentaCliente — JŪSU klienta numurs pie šī piegādātāja, ar kuru ERP saskaņo savus iepirkumus.
Ekvivalences piemaksa ir tikai lasāma
Lauks excluidoRecargoEquivalencia tiek atgriezts, un to var nosūtīt atpakaļ ar to pašu vērtību (lai varētu atgriezt visu objektu), bet tā maiņa caur API atgriež 400: tas nosaka, vai jūsu iepirkumiem no šī piegādātāja piemēro piemaksu, t. i., tas ietekmē jūsu iepirkuma rēķinu apliekamo summu. To maina piegādātāja kartītē. Ārpus Spānijas tam nav nekādas ietekmes.
Piegādātāja kods neidentificē ierakstu
Atšķirībā no klienta koda piegādātāja kods (PROV-004) nav unikāls: tas var atkārtoties pat jūsu pašu servisā. Tādēļ GET /proveedores/{id} pieņem tikai id. Ja jūsu ERP glabā tikai kodu, izmantojiet saraksta filtru: GET /proveedores?codigo=PROV-004, kas atgriež visus atbilstošos, un izvēlieties paši.
Remonta pasūtījumi (tikai lasīšana)
API ļauj skatīt arī remonta pasūtījumus: pasūtījuma numuru, statusu, datumus, ierīci (tips, ražotājs, modelis, sērijas numurs, IMEI) un tāmi. Tā ir tikai lasīšana: pasūtījumi joprojām tiek veidoti un to statuss mainīts Sattotal, kur tiek parakstīta pieņemšanas kvīts un izsniegšana. Atslēgai jābūt atzīmētam resursam Remonti; klientu vai piegādātāju atslēgas tiem nepiekļūst.
Remonta pasūtījuma lauki
Katrā pasūtījumā ir numeroFicha, estado, prioridad, ubicacion, averiaDeclarada, diagnostico, cikla datumi (pieņemšana, diagnostikas un remonta sākums un beigas, paziņojums klientam, izsniegšana un ultimoCambioEstado — kad pārgāja pašreizējā statusā), klienta kopsavilkums (id, codigo, codigoVisible, nombre, apellidos, razonSocial), ierīce (id, codigo, tipo, marca, modelo, numeroSerie, imei, color), tāme (numero, total, estado, fechaEnvio un fechaRespuesta vai null, ja tās nav), piešķirtais tehniķis (tikai vārds) un plazoEntregaEstimado — klientam pieņemšanas kvītī norādītais termiņš. Iekšējās piezīmes, paraksti, fotoattēli, dokumenti un ierīces paroles nekad netiek izsniegti.
Pieprasījums
GET /api/v1/clientes/CLI-0042/reparaciones?estado=reparado Authorization: Bearer sat_Ab3k9…x9Zq
Atbilde (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 }
}Klienta atrašana pēc zvanītāja tālruņa
Ja jūsu CRM vai telefona centrāle ienākoša zvana laikā atver klienta kartīti, izmantojiet GET /clientes?telefono=<tālruņa numurs>. Meklēšana notiek galvenajā un papildu tālrunī, neņemot vērā pieraksta veidu: atstarpes, defises, jūsu valsts starptautisko prefiksu (+34 vai 0034) un sākuma 0. Tā «612 345 678» atrod klientu, kas saglabāts kā «+34 612-345-678». Nepieciešami vismaz 6 cipari.
Klienta kopsavilkums jūsu CRM
GET /clientes/{id}/resumen vienā izsaukumā atgriež to, ko CRM parasti rāda klienta kartītē: totalReparaciones, reparacionesAbiertas (ierīce joprojām ir servisā), porEstado, totalPresupuestado un totalPresupuestosAprobados (servisa valūtā, kas norādīta laukā moneda), primeraReparacion, ultimaReparacion un ultimaActividad (pēdējās izmaiņas jebkurā no viņa pasūtījumiem). Tāpat kā pasūtījumiem, nepieciešams resurss Remonti.
Pieprasījums
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",
…
}
}Sinhronizēt tikai to, kas mainījies
Nav nepieciešams katrā reizē ielādēt visu. Saglabājiet savā rīkā pēdējās izpildes datumu un laiku un pieprasiet tikai tos klientus vai piegādātājus, kas kopš tā laika mainīti, ar parametru actualizadoDesde. Atbilde ir sakārtota pēc izmaiņu datuma augošā secībā ar stabilu papildu kārtošanu, tāpēc to var lapot, neizlaižot ierakstus. Parādās arī arhivētie (ar activo = false), lai jūsu CRM varētu atspoguļot arhivēšanu.
GET /api/v1/clientes?actualizadoDesde=2026-09-18T10:00:00Z&limit=100&page=1 Authorization: Bearer sat_Ab3k9…x9Zq
Pirmā reize
Izejiet cauri GET /clientes ar limit=100 un page=1, 2, 3…, līdz totalPages ir izsmelts. Saglabājiet sākuma laiku.
Nākamās reizes
Pieprasiet GET /clientes?actualizadoDesde=<saglabātais laiks> un apstrādājiet tikai to, kas pienāk. Atkal saglabājiet šīs reizes sākuma laiku.
Sasaistiet, nedublējiet
Saglabājiet Sattotal id kopā ar ierakstu savā CRM. Ja veidošanas laikā saņemat 409 DUPLICADO, atbildē ir existenteId: sasaistiet to, nevis veidojiet jaunu.
Lapošana un meklēšana
Saraksti pieņem page (sākot no 1) un limit (pēc noklusējuma 25, maksimums 100; ja pieprasāt vairāk, tiek samazināts līdz 100). Lauks busqueda meklē vārdā, uzvārdā, uzņēmuma nosaukumā, nodokļu identifikatorā, e-pastā, kodā un tālrunī.
Kļūdu kodi un ko darīt
Visās kļūdu atbildēs ir success: false, paskaidrojošs teksts un stabils code, kas paredzēts lēmumu pieņemšanai programmā. Lūk, kādus varat saņemt:
NO_AUTORIZADOAtslēgas nav, tai ir svešs formāts vai tā neeksistē. Pārbaudiet galveni Authorization.
CLAVE_REVOCADAAtslēga bija derīga, bet administrators to atsauca. Izveidojiet jaunu sadaļā Iestatījumi → API un atjauniniet to savā rīkā.
PLAN_REQUERIDOOrganizācija izmanto bezmaksas plānu. API atkal darbosies pēc pārejas uz maksas plānu.
PERMISO_DENEGADOAtslēgai nav šai darbībai nepieciešamās atļaujas. Atbildē laukā ambitoRequerido norādīts, kuras trūkst: izveidojiet atslēgu ar šo atļauju.
NO_ENCONTRADOJūsu organizācijā nav neviena klienta vai piegādātāja ar šādu id. Citu organizāciju ieraksti nekad nav redzami, un «neeksistē» netiek atšķirts no «nav jūsu».
DUPLICADOIeraksts ar šādiem datiem jau eksistē: nodokļu identifikators vai e-pasts klientiem; nodokļu identifikators, nosaukums vai kods piegādātājiem. Atbildē ir campo un existenteId, lai varētu to sasaistīt, nevis veidot jaunu.
VALIDACIONKāds lauks neiztur validāciju (vai JSON ir kļūdains). Laukā details norādīts lauks un iemesls, tāpat kā veidlapā.
IDENTIFICADOR_FISCAL_REQUERIDOŠim klientam nepieciešams nodokļu identifikators: jūsu valstī tas ir obligāts nosūtītajam klienta tipam (piemēram, vienmēr uzņēmumiem).
RATE_LIMITPārāk daudz pieprasījumu. Pagaidiet galvenē Retry-After norādītās sekundes un mēģiniet vēlreiz.
API_DESACTIVADAAPI uz laiku ir atslēgta apkopes dēļ. Mēģiniet vēlāk vēlreiz.
Ierobežojumi
120 pieprasījumi minūtē uz atslēgu (ar uzviju periodiskai sinhronizācijai; aptur nejaušu cilpu). 10 aktīvas atslēgas vienā organizācijā. Saraksti atgriež ne vairāk kā 100 ierakstus lapā. Ja organizācija izmanto bezmaksas plānu un mēneša kvota ir izsmelta, klientu reģistrēšana tiek apturēta tāpat kā lietotnē.
Soli pa solim: klientu sinhronizācija ar Make
Tipisks scenārijs: ik pēc 15 minūtēm ielādēt savā CRM jaunos vai mainītos klientus un piegādātājus no Sattotal. n8n tas pats tiek panākts ar mezglu HTTP Request un mezglu Schedule.
Izveidojiet atslēgu Sattotal
Iestatījumi → API → Jauna atslēga, atļauja «Tikai lasīšana», ja tikai lasīsiet, vai «Lasīšana un rakstīšana», ja no CRM arī veidosiet klientus. Nokopējiet atslēgu.
HTTP modulis «Make a request»
URL: jūsu bāzes URL + /clientes. Metode GET. Galvene Authorization ar vērtību Bearer un jūsu atslēgu. Atzīmējiet «Parse response», lai strādātu ar JSON.
Pārbaudiet savienojumu
Vispirms vienreiz izpildiet pieprasījumu uz /me: ja tas atgriež jūsu organizāciju un atslēgas nosaukumu, autentifikācija ir kārtībā.
Pievienojiet inkrementālo filtru
Saglabājiet pēdējās izpildes datumu Data store vai mainīgajā un nododiet to URL kā actualizadoDesde. Ieplānojiet scenāriju ik pēc 15 minūtēm.
Kartējiet laukus uz savu CRM
Izejiet cauri data[] un kartējiet id, codigo, nombre, apellidos, email, telefono, nif_cif un direccion. Saglabājiet Sattotal id savā CRM, lai atjauninātu, nevis dublētu.
Lai veidotu klientus no CRM, izmantojiet vēl vienu HTTP moduli ar metodi POST uz /clientes un klienta JSON ķermeni. Ja saņemat 409, izmantojiet existenteId sasaistīšanai.
Labā drošības prakse
Viena atslēga katrai integrācijai
Tā varat atsaukt vienu, nesabojājot pārējās, un sarakstā redzat, kad katra izmantota pēdējoreiz.
Nekad pārlūkprogrammā vai publiskā repozitorijā
Glabājiet to sava rīka akreditācijas datu glabātuvē (Make savienojumos, n8n akreditācijas datos, vides mainīgajos). Ja to augšupielādējat repozitorijā vai tīmekļa vietnē, uzskatiet to par nopludinātu.
Ja tā nopludināta, atsauciet un izveidojiet jaunu
Atsaukšana notiek nekavējoties: vecā atslēga sāk saņemt 401 CLAVE_REVOCADA. Atjauniniet jauno atslēgu savā rīkā, un viss.
API specifikācija
Pilna tehniskā dokumentācija (ceļi, parametri, shēmas un kļūdu kodi) publicēta atvērtā formātā adresē /api/v1/openapi.json, bez atslēgas. Pēc noklusējuma tā ir spāņu valodā; pievienojiet ?lang= ar savu valodu, lai saņemtu tulkotu versiju (piemēram, /api/v1/openapi.json?lang=en vai ?lang=ro). To var importēt Postman, Insomnia, Make vai n8n, lai visi izsaukumi būtu sagatavoti.
Biežāk uzdotie jautājumi
Esmu pazaudējis atslēgu. Vai varu to apskatīt vēlreiz?
Nē. Tā tiek parādīta tikai izveides brīdī un pēc tam saglabāta neatgriezeniski. Atsauciet to sadaļā Iestatījumi → API un izveidojiet jaunu.
Vai ir webhooks, lai Sattotal paziņotu manam CRM, kad kaut kas mainās?
Pagaidām nav. Ieteicamais veids ir periodiski veikt vaicājumus ar parametru actualizadoDesde, kas atgriež tikai izmainīto.
Kādus datus atklāj API?
Klientus un piegādātājus: uzskaitīt, veidot, skatīt, atjaunināt un arhivēt. Atļaujas tiek piešķirtas pa resursiem, tāpēc atslēga, kas izveidota pirms piegādātāju ieviešanas, tiem nepiekļūst, kamēr administrators to neatzīmē. Turklāt — remonta pasūtījumi tikai lasīšanas režīmā (statuss, datumi, ierīce un tāme) ar savu atļauju.
Vai varu izdzēst klientu caur API?
Nē, tikai arhivēt (activo = false), tāpat kā lietotnē. Tas attiecas gan uz klientiem, gan piegādātājiem. Arhivēts ieraksts joprojām parādās sinhronizācijā, lai jūsu CRM to atspoguļotu.
Vai API ir pieejama bezmaksas plānā?
Nē. Tā ir iekļauta Basic, Pro un Enterprise plānos un izmēģinājuma periodā. Bezmaksas plānā joprojām varat skatīt un atsaukt izveidotās atslēgas.
Pienāk tikai klienta uzvārds. Kāpēc vārds netiek saglabāts?
Gandrīz vienmēr vaina ir lauku kartēšanā: vārdam jābūt laukā nombre, bet uzvārdam — laukā apellidos. Ja jūsu rīks sūta vārdu ar citu atslēgu (firstName, name, apellido…), API to atmet un norāda to atbildes laukā avisos.camposIgnorados. Izlabojiet kartēšanu un nosūtiet klientu vēlreiz ar PATCH.
Vai varu atrast klientu pēc numura, no kura man zvana?
Jā. Pieprasiet GET /api/v1/clientes?telefono= ar numuru tādu, kādu to saņemat: nav svarīgi, vai tam ir starptautiskais prefikss, atstarpes vai defises, un meklēšana notiek arī papildu tālrunī. Ar klienta id pēc tam varat pieprasīt viņa remonta pasūtījumus (/clientes/{id}/reparaciones) un kopsavilkumu (/clientes/{id}/resumen).