Вовед

Овој документ опишува како функционира официјалниот додаток WooCommerce за интеграција со платформата Ananas, кои се неговите функционалности и кои се техничките барања за успешна имплементација.

Што е WooCommerce додаток?

За продавачите кои ја користат платформата WooCommerce (WordPress), Ananas разви посебен додаток кој овозможува директна и едноставна интеграција.

Додатокот овозможува автоматско ажурирање на следниве податоци:

• Редовни цени на производи
• Количини на производи

Можете да ја преземете екстензијата преку следниов линк: Додаток за WooCommerce

Технички барања и правила за успешна интеграција

• Jedinstveni SKU za varijacije 
  • Секоја варијација на производот (на пр. различни бои и големини) мора да има уникатен SKU . Во спротивно, синхронизацијата нема да работи правилно.
• Automatsko ažuriranje količina 
  • Работи само ако вредностите се изразени нумерички (на пр. 5, 10, 0).
  • Не е можно да се интегрира статусот „на залиха / нема на залиха“.
• Promotivne cene 
  • Тие можат да се синхронизираат само ако датумите на почеток и крај на промоцијата се поставени на самиот производ . Во спротивно, се синхронизираат само редовните цени .
• Tehnički zahtevi hostinga 
  • Хостингот мора да поддржува поставување „Cron Job“ за WordPress/WooCommerce.
  • Ова е неопходно за оптимално функционирање на интеграцијата без нарушување на корисничкото искуство на страницата.

Заклучок

Детални упатства за инсталирање и поставување на приклучокот WooCommerce можете да најдете на линкот: Ananas Integration – Install and Setup.docx . За дополнителни информации во врска со користењето на приклучокот WooCommerce, можете да контактирате со тимот на integrations@ananas.rs.

Број на каталог на документи:

Верзија на документот: 1.0

Датум на промена: 26.3.2025.

Вовед

Овој документ опишува како функционира интеграцијата на REST API со платформата Ananas, кои се нејзините предности и кои функционалности можат да се автоматизираат со користење на овој тип на поврзување.

Што е REST API интеграција?

Доколку веќе имате развиено REST API, партнерскиот интегратор на Ananas може да изврши поврзување кое ги вклучува следниве работи:

• Преземање информации од вашето API

• Прилагодување на податоците на форматот потребен од Pineapple Public API

Оваа интеграција овозможува ефикасна и автоматска размена на податоци помеѓу вашиот систем и платформата Ananas, без потреба од дополнително рачно внесување.

Функции што можат да се автоматизираат преку интеграција на REST API

• Редовно ажурирање на цените
  • Редовните цени се ажурираат на основа „денес за утре“
  • Цената испратена денес станува активна по полноќ
  • Опцијата „денес за денес“ постои само во периодот 00:00–02:00

• Ажурирање на количините
  • Количините можат да се ажурираат неколку пати на ден, според динамиката на вашиот систем
• Управување со акции
  • Акциите може да се испланираат однапред или на истиот ден
  • Потребно е да се испрати промотивната цена , со датумите на почеток и крај, доколку се достапни.
  • Доколку датумите не се достапни, партнерскиот интегратор го поставува времетраењето на акцијата на 1 ден.
  • Времетраење на дејството: минимум 1 ден , максимум 30 дена
  • За време на кампањата:
    • Не може да се прекине дејството
    • Не е можно да се промени редовната цена
    • Не е можно да се промени датумот на истекување
    • Можно е само да се намали промотивната цена

Забелешка

Интеграцијата на ST API е идеална за продавачи кои веќе имаат свои системи и сакаат да одржат целосна контрола врз податоците, додека партнерскиот интегратор им овозможува да ја прилагодуваат и комуницираат со платформата Ananas.

За успешна интеграција, потребно е податоците што ги дава API-то да содржат уникатен идентификатор на производот (SKU или EAN), како и сите потребни информации за синхронизација (количина, редовна цена, специјална цена).

Заклучок

За дополнителни информации за интеграцијата со REST API, можете да контактирате со тимот за интеграции на integrations@ananas.rs

Број на каталог на документи:

Верзија на документот: 1.0

Датум на промена: 26.3.2025.

Вовед

Овој документ објаснува како функционира FTP интеграцијата со платформата Ananas, какви податоци можете да разменувате и како да го користите FTP како алтернативен метод ако немате динамичен XML фид.

Што е FTP интеграција?

FTP интеграцијата овозможува размена на податоци помеѓу вашиот систем и Ananas преку датотеки во XML, CSV или XLS формати.

Постојат две можности:

• Ананасот презема датотеки од вашиот сервер

• Вие прикачувате датотеки на серверот Ananas

Имплементацијата на оваа интеграција ја врши нашиот партнер интегратор .

Функции што можат да се автоматизираат преку FTP интеграција

• Редовно ажурирање на цените
  • Цените се ажурираат врз основа на принципот „денес за утре“
  • Цената испратена денес ќе биде активна по полноќ
  • Опцијата „денес за денес“ е достапна помеѓу 00:00 и 02:00 часот
• Ažuriranje količina 
  • Количините може да се ажурираат неколку пати на ден, во зависност од вашиот систем
• Upravljanje akcijama 
  • Акциите може да се закажат однапред или на истиот ден
  • Потребно е да ја испратите промотивната цена , заедно со датумите на почеток и крај, доколку ги имате.
  • Доколку датумите не се достапни, партнерскиот интегратор го поставува времетраењето на акцијата на 1 ден.
  • Акцијата може да трае минимум 1 ден , максимум 30 дена
  • Tokom trajanja akcije: 
    • Не може да се прекине дејството
    • Не е можно да се промени редовната цена
    • Не може да се променат датумите
    • Можно е само да се намали промотивната цена

Забелешка:

FTP интеграцијата ја користи истата логика како XML фидот кога станува збор за форматирање на податоци и обработка на информации.

За успешна интеграција, потребно е да имате:

• Уникатен идентификатор на производ (SKU или EAN)

• Информации за количина, редовна цена и евентуално специјална цена

Структурата на датотеките во сопственост на добавувачот не е важна. Откако добавувачот ќе го достави шаблонот што го поседува, нашиот интегратор започнува со работа на мапирање на терен.

Заклучок

За дополнителни информации во врска со FTP интеграцијата, можете да контактирате со тимот за интеграција на integrations@ananas.rs

Број на каталог на документи:

Верзија на документот: 1.0

Датум на промена: 26.3.2025.

Вовед

Овој документ опишува како функционира XML интеграцијата со платформата Ananas, кои функции можат да се автоматизираат, кои се техничките и оперативните барања, како и предностите на овој тип на поврзување.

Што е XML интеграција?

XML интеграцијата е поддржана од надворешен партнерски интегратор. Овој тип на интеграција подразбира дека продавачот обезбедува врска до неговиот динамичен XML фид , а партнерскиот интегратор ги презема податоците, ги подготвува и ги проследува до системот Ananas.

Функции што можат да се автоматизираат преку XML интеграција

• Редовно ажурирање на цените
  • Редовната цена се ажурира врз основа на „денес за утре“.
  • Цената испратена денес станува активна по полноќ.
  • Можноста за поставување на цената „денес за денес“ постои само помеѓу 00:00 и 02:00 часот .
• Ажурирање на количините
  • Можни се повеќекратни ажурирања во текот на денот, според внатрешниот систем на продавачот.
• Управување со акции
  • Акциите можат да бидат испланирани однапред или на истиот ден.
  • Потребно е да ја испратите промотивната цена и, доколку е достапна, датумите на почеток и крај.
  • Доколку датумите не се достапни, интеграторот автоматски ќе го постави времетраењето на акцијата на 1 ден .
  • Времетраење на акцијата: минимум 1 ден , максимум 30 дена .
  • За време на кампањата, не е можно:
    • Запрете ја акцијата
    • Променете ја редовната цена
    • Променете ги датумите на истекување
  • Намалувањето на промотивната цена е можно само за време на траењето на промоцијата

Дополнителни информации

XML-датотеката може да содржи податоци за наведување производи, но новите производи нема да бидат автоматски наведени . За да наведете нови производи, контактирајте го вашиот менаџер на сметки преку е-пошта.

За валидна интеграција, потребно е да имате барем еден од следниве идентификатори:

• SKU или EAN код
• Количина, редовна цена и информации за залиха (доколку се користат)

Можете да ја преземете структурата на посакуваната XML-датотека од следниот документ: линк

Временска рамка и цена

• Време на имплементација: од 3 до 7 дена

• Цена на почетна интеграција: 200 евра

• Месечно одржување: 30 евра

• Начинот на плаќање се договара директно со партнерот интегратор

Заклучок

За дополнителни информации во врска со XML интеграцијата, можете да контактирате со тимот за интеграции на integrations@ananas.rs

Број на каталог на документи:

Верзија на документот: 1.0

Датум на промена: 26.3.2025.

Овој документ дава преглед на интеграцијата на Ananas Public API како најкомплетно решение за бизнис автоматизација на платформата Ananas.

Што е Pineapple Public API?

Јавното API на Ananas е напредна опција за интеграција што овозможува целосна автоматизација на сите функционалности достапни на платформата. Вашиот систем може директно да комуницира со платформата Ananas, што значи дека лесно можете да управувате со производи, промоции и нарачки без потреба од рачно внесување.

За технички детали и документација, посетете го порталот за програмери на Ananas : https://developer.ananas.rs

Процес на имплементација

• Имплементацијата започнува со тестирање на функционалноста што сакате да ја автоматизирате.

• По успешното тестирање, тимот на Ananas ви обезбедува API клучеви за продукција .

• Должината на имплементацијата зависи од сложеноста на вашиот систем и функционалноста што ја интегрирате.

• Типичен временски период: од 7 до 30 дена .

Функции што можат да се автоматизираат преку API

• Slanje kataloga 
  • Можете директно да испратите каталог на производи.
  • Задолжителните полиња за испраќање каталози се достапни на:
    https://developer.ananas.rs/developer-portal/bulk-products/

• Преземање информации за наведените производи
  • Можете да добиете информации за цени, количини, магацин, опис, ID и други атрибути во секое време.
• Ažuriranje količina 
  • Можни се повеќекратни ажурирања во текот на денот, во зависност од вашите внатрешни системи.
• Редовно ажурирање на цените
  • Цените се планирани „денес за утре“.
  • Редовната цена испратена денес станува активна по полноќ .
  • Цената „денес за денес“ е можна само во периодот 00:00–02:00 .
• Upravljanje akcijama 
  • Акциите можат да бидат испланирани однапред или на истиот ден.
  • Задолжително е да ги испратите датумите на почеток и крај.
  • Времетраење: минимум 1 ден , максимум 30 дена .
  • Откако ќе се започне, дејството не може да се запре .
  • Tokom trajanja akcije: 
    • Не е можно да се промени редовната цена
    • Не е можно да се промени датумот на истекување
    • Можно е само да се намали промотивната цена
• Upravljanje porudžbinama 
  • Можно е автоматизирано управување со приемот и обработката на нарачките.
• Preuzimanje fiskalnih računa / specifikacija porudžbina 
  • API-то овозможува преземање на фискални документи и сите релевантни податоци за нарачката.

Заклучок

За дополнителни информации во врска со интеграцијата на јавниот API, можете да контактирате со тимот за интеграција на integrations@ananas.rs , а исто така можете да го погледнете и видеото подолу.

Овој документ има за цел да објасни што се интеграции со Pineapple, какви видови интеграции постојат и кои се главните придобивки од нивното користење во секојдневното работење на продавачите на платформата.

Што се интеграции?

Интеграциите овозможуваат полесно и поефикасно управување со производите и нарачките на платформата Ananas преку автоматизација на процесите. Тие значително заштедуваат време , ја намалуваат можноста за човечки грешки и ја подобруваат точноста на информациите.

Со користење на интеграции, продавачите можат да автоматизираат голем дел од своите операции и да се фокусираат на раст и развој на бизнисот.

Видови интеграции на Ananas

Моментално, достапни се неколку опции за поврзување на системот на продавачот со платформата Ananas:

• Pineapple Public API : Комплетно решение за напредни корисници и ИТ тимови кои сакаат целосна контрола врз своите податоци.

• XML динамичен фид : Погодно за продавачи кои сакаат редовно и автоматизирано освежување на податоците за производите.

• REST API : Модерен и флексибилен начин за поврзување на системи со Pineapple.

• Додаток за WooCommerce : Идеален за продавачи кои ја користат платформата WooCommerce.

• FTP размена : Погодно за продавачи кои имаат статички датотеки и претпочитаат размена преку сервер.

Функции што ги поддржуваат интеграциите

Со помош на интеграциите, следните функции можат да се автоматизираат:

• Испрати каталог на производи

• Преземање информации за наведените производи

• Ажурирање на количините

• Редовно ажурирање на цените

• Управување со акции и промоции

• Управување со нарачки

• Преземање на фискални фактури и спецификации за нарачки

Заклучок

За повеќе информации за интеграциите и како да ги имплементирате, можете да контактирате со тимот за интеграции на integrations@ananas.rs или да го погледнете видеото подолу.