API och integrationer (CRM, Make, n8n)

Kan lista och slå upp den resursen. Varje försök att skapa, ändra eller arkivera får ett 403-fel med koden PERMISO_DENEGADO och den behörighet som saknas.

Kan förutom att slå upp även skapa, uppdatera och arkivera i den resursen. Det är behörigheten en tvåvägssynkronisering behöver.

Behörigheterna gäller per resurs, och det har redan märkts: när leverantörerna lades till fick de nycklar som redan fanns — alla för kunder — INTE tillgång till dem. De måste bockas för. Samma sak gäller varje resurs som läggs till framöver: en integration ser aldrig mer än vad du gett den.

Fälten är samma som i kundkortet: nombre och tipo (particular eller empresa) är obligatoriska; nif_cif, apellidos, razonSocial, email, telefono, telefonoSecundario, direccion (calle, numero, piso, codigoPostal, localidad, provincia, pais) och notas är valfria. Skatte-ID:t sparas med versaler och e-posten med gemener. I svaret finns alla nycklar alltid med, med null när värde saknas, så att fältmappningen i ditt verktyg inte går sönder. Tänk på namnet: nombre är förnamnet (eller företagsnamnet för ett företag) och efternamnet anges separat i apellidos, i plural.

Om body innehåller en nyckel som inte finns (till exempel firstName i stället för nombre, eller apellido i singular i stället för apellidos) avvisas inte anropet, men värdet sparas inte. För att det inte ska gå obemärkt förbi innehåller svaret vid skapande och redigering av kunder avisos.camposIgnorados med en lista över de nycklarna; adressfält anges med sin sökväg, till exempel direccion.ciudad. Ser du den, kontrollera fältmappningen i din integration. Fält som API:et själv returnerar (id, codigo, createdAt …) ger aldrig någon varning, så du kan läsa en kund, ändra den och skicka tillbaka den i sin helhet.

Bara nombre är obligatoriskt. Valfria: codigo, cif, email, telefono, telefonoSecundario, web, direccion (på en enda rad, inte ett objekt som hos kunderna), ciudad, provincia, codigoPostal, pais, contactos, tipoProveedor (general, producto, servicio, logistica eller otro), formaPago, plazoPago (i dagar; 0 betyder betalning direkt), cuentaCliente och notas. Varje kontakt har nombre — obligatoriskt — samt cargo, telefono, email och notas; kontakterna har ingen egen identifierare.

Listan du skickar ERSÄTTER den som fanns. Skickar du en tom lista raderas alla kontakter; skickar du inte nyckeln alls (eller skickar null) ligger de kvar som de var. Det är det som gör att du kan läsa en leverantör, ändra ett fält och skicka tillbaka hela objektet utan konstiga effekter.

Till skillnad från kundens är leverantörskoden (PROV-004) inte unik: den kan förekomma flera gånger även inne på din egen verkstad. Därför tar GET /proveedores/{id} bara emot id:t. Sparar ditt ERP bara koden använder du filtret i listan: GET /proveedores?codigo=PROV-004 returnerar alla som matchar, och du avgör vilken det är.

Varje ärende innehåller numeroFicha, estado, prioridad, ubicacion, averiaDeclarada, diagnostico, datumen i flödet (inlämning, start och slut för felsökning och reparation, avisering till kunden, utlämning och ultimoCambioEstado, när ärendet fick sin nuvarande status), en kundsammanfattning (id, codigo, codigoVisible, nombre, apellidos, razonSocial), enheten (id, codigo, tipo, marca, modelo, numeroSerie, imei, color), offerten (numero, total, estado, fechaEnvio och fechaRespuesta, eller null om det inte finns någon), den tilldelade teknikern (endast namnet) och plazoEntregaEstimado, den leveranstid kunden fick på inlämningskvittot. Interna anteckningar, signaturer, foton, dokument och enhetens lösenord returneras aldrig.

Om ditt CRM eller din växel öppnar kundkortet när ett samtal kommer in använder du GET /clientes?telefono=<nummer>. Sökningen görs i både det primära och det sekundära telefonnumret, oavsett hur numret är skrivet: mellanslag, bindestreck, landsnumret (+46 eller 0046) och den inledande nollan ignoreras. Då hittar ”070 123 45 67” en kund som är sparad som ”+46 70-123 45 67”. Det krävs minst 6 siffror.

GET /clientes/{id}/resumen returnerar i ett enda anrop det som ett CRM brukar visa på kundkortet: totalReparaciones, reparacionesAbiertas (enheten finns kvar på verkstaden), porEstado, totalPresupuestado och totalPresupuestosAprobados (i verkstadens valuta, som anges i moneda), primeraReparacion, ultimaReparacion och ultimaActividad (den senaste ändringen i något av kundens ärenden). Precis som ärendena kräver det resursen Reparationer.

Listor tar emot page (från 1) och limit (25 som standard, högst 100; begär du mer kapas det till 100). Fältet busqueda söker i namn, efternamn, företagsnamn, skatte-ID, e-post, kod och telefon.

120 förfrågningar per minut och nyckel (gott och väl för en periodisk synkronisering; det stoppar en oavsiktlig loop). 10 aktiva nycklar per organisation. Listor returnerar högst 100 poster per sida. Är organisationen på gratisplanen med månadskvoten förbrukad stoppas skapandet av kunder precis som i appen.

Då kan du återkalla en utan att de andra slutar fungera, och i listan ser du när var och en användes senast.

Spara den i ditt verktygs lager för autentiseringsuppgifter (anslutningar i Make, credentials i n8n, miljövariabler). Laddar du upp den till ett repo eller en webbplats ska du betrakta den som läckt.

Återkallandet gäller direkt: den gamla nyckeln börjar få 401 CLAVE_REVOCADA. Uppdatera den nya i ditt verktyg, så är det klart.

Den fullständiga tekniska referensen (sökvägar, parametrar, scheman och felkoder) är publicerad i ett öppet format på /api/v1/openapi.json, utan att någon nyckel behövs. Som standard är den på spanska; lägg till ?lang= med ditt språk för att få den översatt (till exempel ?lang=sv eller /api/v1/openapi.json?lang=en). Du kan importera den i Postman, Insomnia, Make eller n8n för att ha alla anrop färdiga.