PHPackages                             magazord-plataforma/marketplace-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. magazord-plataforma/marketplace-sdk

ActiveLibrary[API Development](/categories/api)

magazord-plataforma/marketplace-sdk
===================================

SDK de integração com a API do marketplace da plataforma Magazord

015.8k↓47.4%PHP

Since May 22Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/magazord-plataforma/marketplace-sdk)[ Packagist](https://packagist.org/packages/magazord-plataforma/marketplace-sdk)[ RSS](/packages/magazord-plataforma-marketplace-sdk/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (2)Used By (0)

Marketplace Magazord SDK
========================

[](#marketplace-magazord-sdk)

SDK PHP de integração com a API do marketplace da plataforma [Magazord](http://www.magazord.com.br)

Instalação
----------

[](#instalação)

Disponível via [Composer](https://packagist.org/packages/magazord-plataforma/marketplace-sdk).

Uso
---

[](#uso)

### Anúncios (/items)

[](#anúncios-items)

#### Envio do anúncio para o marketplace (POST /items)

[](#envio-do-anúncio-para-o-marketplace-post-items)

```
// Criar o objeto de envio
$sender = new \MagaMarketplace\ItemSender($endpoint, $user, $password);

// Criar o objeto com os dados do anúncio
$item = new \MagaMarketplace\Domain\Item\Item();
$item->setId('XT1580-PRETO');
$item->setTitle('Smartphone Motorola Moto X Force XT1580 Desbloqueado Preto');
$item->setBrand('Motorola');
$item->setCategory('Smartphone');
$item->setDescription('Feito para quem procura poder e exclusividade, o Motorola Moto X Force XT1580 chegou para conquistar um mundo de fãs...');
$item->setDimensions(new \MagaMarketplace\Domain\Item\Dimension());
$item->getDimensions()->setHeight(15.00);
$item->getDimensions()->setLength(0.90);
$item->getDimensions()->setWidth(7.80);
$item->setWeight(0.169);
$item->setEan('7892597338238');
$item->setStock(new \MagaMarketplace\Domain\Item\Stock());
$item->getStock()->setQuantity(10);
$item->setImages(array(
    'https://d2yd0u3irqwx65.cloudfront.net/img/2015/12/produto/25671/19/large/moto-x-force-xt1580-preto.jpg',
    'https://d2yd0u3irqwx65.cloudfront.net/img/2015/12/produto/25675/19/large/traseira-motorola-moto-x-force-xt1580-preto.jpg'
));
$item->setVideos(array());
$item->addAttribute('SO', 'Android');
$item->addAttribute('SO Versão', '6.0');
$item->addAttribute('Câmera Frontal', '5MP');
$item->addAttribute('Câmera', '21MP');
$item->setPrice(new \MagaMarketplace\Domain\Item\Price());
$item->getPrice()->setDefault(2499.99);
$item->getPrice()->setSale(1999.99);
$item->setProductId('8030');
$item->addVariation('Cor', 'Preto');
$item->setWarranty('1 ano');
$item->setActive(true);

// Realizando o envio
$response = $sender->post($item);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Consulta de anúncios (GET /items)

[](#consulta-de-anúncios-get-items)

```
// Criar o objeto de envio
$sender = new \MagaMarketplace\ItemSender($endpoint, $user, $password);

// Criar o objeto com os filtros da consulta
$filter = new \MagaMarketplace\Domain\Filter\ItemListFilter();
// Setar filtros necessários
// $filter->setStatus(\MagaMarketplace\Domain\Item\ItemResponse::STATUS_SELLING);
// Parametros de paginação de registros
$filter->setOffset(0);
$filter->setLimit(10);

// Realizando a consulta
$response = $sender->getList($filter);
if ($response->isSuccess()) {
    // $response é uma instancia de \MagaMarketplace\Domain\Item\ItemListResponse
    echo 'Sucesso! ';
    foreach ($response->getList() as $itemResponse) {
        echo $itemResponse->getId() . ' - ' . $itemResponse->getTitle() . '';
    }
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Consulta de anúncio por id (GET /items/{id})

[](#consulta-de-anúncio-por-id-get-itemsid)

```
// Criar o objeto de envio
$sender = new \MagaMarketplace\ItemSender($endpoint, $user, $password);
// Realizando a consulta
$response = $sender->get('XT1580-PRETO');
if ($response->isSuccess()) {
    // $response é uma instancia de \MagaMarketplace\Domain\Item\ItemResponse
    echo 'Sucesso! ' . $response->getTitle() . '';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Atualização do preço do anúncio (PUT /items/{id}/price)

[](#atualização-do-preço-do-anúncio-put-itemsidprice)

```
$price = new \MagaMarketplace\Domain\Item\Price();
$price->setDefault(2499.99);
$price->setSale(2199.99);
$response = $sender->putPrice('XT1580-PRETO', $price);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Atualização do Estoque do anúncio (PUT /items/{id}/stock)

[](#atualização-do-estoque-do-anúncio-put-itemsidstock)

```
$stock = new \MagaMarketplace\Domain\Item\Stock();
$stock->setQuantity(20);
$response = $sender->putStock('XT1580-PRETO', $stock);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Ativar/desativar anúncio (PUT /items/{id}/active)

[](#ativardesativar-anúncio-put-itemsidactive)

```
$active = new \MagaMarketplace\Domain\Item\Active();
$active->setActive(true);
$response = $sender->putActive('XT1580-PRETO', $active);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

### Pedidos (/orders)

[](#pedidos-orders)

#### Criar pedido no marketplace (POST /orders) (Somente SANDBOX)

[](#criar-pedido-no-marketplace-post-orders-somente-sandbox)

```
// Criar o objeto de envio
$sender = new \MagaMarketplace\OrderSender($endpoint, $user, $password);
// Data atual
$dateTime = new \DateTime();
// Criar o objeto com os dados do pedido
$order = new \MagaMarketplace\Domain\Order\Order();
$order->setSiteId('00120042342415');
$order->setStore('Cissa Magazine');
$order->setDateCreated($order->toDateTimeString($dateTime)); // Ex: 2017-01-03T14:09:03-02:00
$order->setClient(new \MagaMarketplace\Domain\Order\Client());
$order->getClient()->setName('Consumidor Final');
$order->getClient()->setDocumentNumber('999.999.999-99');
$order->getClient()->addPhone('47 99999999', \MagaMarketplace\Domain\Order\Telephone::TYPE_CELLPHONE);
$order->setShippingAddress(new \MagaMarketplace\Domain\Order\ShippingAddress());
$order->getShippingAddress()->setAddressType(\MagaMarketplace\Domain\Order\ShippingAddress::TYPE_RESIDENTIAL);
$order->getShippingAddress()->setReceiverName('Consumidor Final');
$order->getShippingAddress()->setReceiverPhone('47 99999999');
$order->getShippingAddress()->setStreet('Estrada da Madeira');
$order->getShippingAddress()->setNumber('1875');
$order->getShippingAddress()->setAdditionalInfo('Magamobi');
$order->getShippingAddress()->setNeighborhood('Barragem');
$order->getShippingAddress()->setCity('Rio do Sul');
$order->getShippingAddress()->setZipcode(89165063);
$order->getShippingAddress()->setState('SC');
$orderItem = new \MagaMarketplace\Domain\Order\OrderItem();
$orderItem->setItem(\MagaMarketplace\Domain\Link::itemsLink('XT1580-PRETO'));
$orderItem->setQuantity(2);
$orderItem->setPrice(1999.99);
$orderItem->setStatus(\MagaMarketplace\Domain\Order\Order::STATUS_NEW);
$orderItem->setTotal($orderItem->getPrice() * $orderItem->getQuantity());
$order->addItem($orderItem);
$order->setFreight(14.99);
$order->setTotalAmount($order->getFreight() + $orderItem->getTotal());
$dateTime->modify('+6days');
$order->setEstimatedDeliveryDate($order->toDateString($dateTime));
$order->setShippingService('PAC');
// Enviar
$response = $sender->post($order);
if ($response->isSuccess()) {
    // $response é uma instancia de \MagaMarketplace\Domain\Order\OrderResponse
    echo 'Sucesso! Número pedido ' . $response->getId();
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Consulta de pedidos (GET /orders)

[](#consulta-de-pedidos-get-orders)

```
// Criar o objeto de envio
$sender = new \MagaMarketplace\OrderSender($endpoint, $user, $password);

// Criar o objeto com os filtros da consulta
$filter = new \MagaMarketplace\Domain\Filter\OrderListFilter();
// Setar filtros necessários
//$filter->setStatus(\MagaMarketplace\Domain\Order\OrderResponse::STATUS_APPROVED);
// Parametros de paginação de registros
$filter->setOffset(0);
$filter->setLimit(10);

// Realizando a consulta
$response = $sender->getList($filter);
if ($response->isSuccess()) {
    // $response é uma instancia de \MagaMarketplace\Domain\Order\OrderListResponse
    echo 'Sucesso! ';
    foreach ($response->getList() as $orderResponse) {
        echo $orderResponse->getId() . ' - ' . $orderResponse->getClient()->getName() . '';
    }
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Consulta de pedido por id (GET /orders/{id})

[](#consulta-de-pedido-por-id-get-ordersid)

```
$orderId = '67';
// Criar o objeto de envio
$sender = new \MagaMarketplace\OrderSender($endpoint, $user, $password);
// Realizando a consulta
$response = $sender->get($orderId);
if ($response->isSuccess()) {
    // $response é uma instancia de \MagaMarketplace\Domain\Order\OrderResponse
    echo 'Sucesso! ' . $response->getClient()->getName() . '';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Atualização status do pedido para aprovado (PUT /orders/{id}/approved) (Somente SANDBOX)

[](#atualização-status-do-pedido-para-aprovado-put-ordersidapproved-somente-sandbox)

```
$sender = new \MagaMarketplace\OrderSender($endpoint, $user, $password);

$tracking = new \MagaMarketplace\Domain\Order\Approved();
$tracking->addItem('XT1580-PRETO', 2);
$tracking->setEventDate($tracking->toDateTimeString(new \DateTime()));
$response = $sender->putApproved($orderId, $tracking);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Atualização status do pedido para enviado/em transporte (PUT /orders/{id}/shipped)

[](#atualização-status-do-pedido-para-enviadoem-transporte-put-ordersidshipped)

```
$tracking = new \MagaMarketplace\Domain\Order\Shipping();
$tracking->addItem('XT1580-PRETO', 2);
$tracking->setEventDate($tracking->toDateTimeString(new \DateTime()));
$tracking->setCarrier(new \MagaMarketplace\Domain\Order\Carrier());
$tracking->getCarrier()->setName('Correios');
$tracking->setTrackingNumber('PN424048589BR');
$tracking->setInvoice(new \MagaMarketplace\Domain\Order\Invoice());
$tracking->getInvoice()->setNumber(123456);
$tracking->getInvoice()->setLine('1');
$tracking->getInvoice()->setIssueDate($tracking->getEventDate());
$tracking->getInvoice()->setAccessKey('42160412687276000179550010005396501000415050');

$response = $sender->putShipped($orderId, $tracking);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Atualização status do pedido para entregue (PUT /orders/{id}/delivered)

[](#atualização-status-do-pedido-para-entregue-put-ordersiddelivered)

```
$tracking = new \MagaMarketplace\Domain\Order\Delivery();
$tracking->addItem('XT1580-PRETO', 2);
$tracking->setEventDate($tracking->toDateTimeString(new \DateTime()));

$response = $sender->putDelivered($orderId, $tracking);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

#### Atualização status do pedido para cancelado (PUT /orders/{id}/canceled)

[](#atualização-status-do-pedido-para-cancelado-put-ordersidcanceled)

```
$tracking = new \MagaMarketplace\Domain\Order\Canceled();
$tracking->addItem('XT1580-PRETO', 2);
$tracking->setEventDate($tracking->toDateTimeString(new \DateTime()));
$tracking->setReason('Solicitado pelo cliente');

$response = $sender->putCanceled($orderId, $tracking);
if ($response->isSuccess()) {
    echo 'Sucesso!';
} else {
    // $response é uma instancia de \MagaMarketplace\Domain\Error
    echo 'Erro:' . $response;
}
```

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance60

Regular maintenance activity

Popularity25

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 96.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/24880850?v=4)[MagaZord - Soluções para e-commerce](/maintainers/magazord-plataforma)[@magazord-plataforma](https://github.com/magazord-plataforma)

---

Top Contributors

[![zordmaster](https://avatars.githubusercontent.com/u/105112964?v=4)](https://github.com/zordmaster "zordmaster (85 commits)")[![djonatan-mz](https://avatars.githubusercontent.com/u/130787458?v=4)](https://github.com/djonatan-mz "djonatan-mz (2 commits)")[![maiconsasse](https://avatars.githubusercontent.com/u/8394048?v=4)](https://github.com/maiconsasse "maiconsasse (1 commits)")

### Embed Badge

![Health badge](/badges/magazord-plataforma-marketplace-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/magazord-plataforma-marketplace-sdk/health.svg)](https://phpackages.com/packages/magazord-plataforma-marketplace-sdk)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35916.4M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

93459.5k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)