Ver categorias

Documentación para Consulta y Actualización del Flujo de Pedidos mediante API Marketplace Soulmkt (V2)

Tabela de conteúdos (TOC)

Esta documentación tiene como objetivo guiarte paso a paso en el proceso de consulta y actualización del flujo de pedidos en una tienda del Marketplace Soulmkt utilizando las APIs V1 y V2. Incluso si no tienes experiencia previa, esta explicación detallada te ayudará a comprender y ejecutar correctamente el procedimiento.

1. Introducción #

El Marketplace Soulmkt ofrece dos versiones de API (V1 y V2) para interactuar con el sistema y realizar operaciones como la consulta y actualización del flujo de pedidos. Ambas versiones utilizan el protocolo SOAP (Simple Object Access Protocol) para el envío y recepción de datos en formato XML.

Aquí abordaremos cómo ejecutar estas acciones con ejemplos de solicitudes XML que puedes enviar utilizando herramientas como Postman.

2. Requisitos Previos #

  • Acceso a la API del Marketplace Soulmkt: Necesitarás credenciales de acceso (usuario y contraseña) para obtener un sessionId, que es necesario para autenticar las solicitudes.
  • Identificador del Pedido: El ID del pedido que deseas actualizar.
  • Herramienta para Enviar Solicitudes: Se recomienda el uso de Postman u otra herramienta que permita enviar solicitudes SOAP.

3. Flujo de Pedidos en la Plataforma #

3.1. Obtención del sessionId

(https://api.soulmkt.dev/examples.phtml)

Antes de realizar cualquier operación, debes obtener un sessionId mediante una solicitud de login.


<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns1="urn:OpenMage"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
	<SOAP-ENV:Body>
		<ns1:login>
			<username xsi:type="xsd:string">seu_usuario</username>
			<apiKey xsi:type="xsd:string">sua_senha</apiKey>
		</ns1:login>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Respuesta:

Si el inicio de sesión se realiza correctamente, recibirás un sessionId que deberás usar en las siguientes solicitudes.


<SOAP-ENV:Envelope>
	<SOAP-ENV:Body>
		<ns1:loginResponse>
			<result xsi:type="xsd:string">1234567890abcdef1234567890abcdef</result>
		</ns1:loginResponse>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.2. Consulta de Pedidos Pagados

(https://api.soulmkt.dev/sales_order.info.phtml)

Mediante la API V2 puedes consultar pedidos filtrando por status (por ejemplo, “processing”).

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns1="urn:OpenMage"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
	<SOAP-ENV:Body>
		<ns1:salesOrderList>
			<sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
			<filters xsi:type="ns1:filters">
				<filter SOAP-ENC:arrayType="ns1:associativeEntity[1]" xsi:type="SOAP-ENC:Array">
					<item xsi:type="ns1:associativeEntity">
						<key xsi:type="xsd:string">status</key>
						<value xsi:type="xsd:string">processing</value>
					</item>
				</filter>
			</filters>
		</ns1:salesOrderList>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Campos Relevantes:

  • sessionId: Token de autenticación.
  • key: Atributo por el que deseas filtrar (ej. status).
  • value: Valor correspondiente al atributo (ej. processing).
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns1="urn:OpenMage"
	xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
	<SOAP-ENV:Body>
		<ns1:salesOrderListResponse>
			<result SOAP-ENC:arrayType="ns1:salesOrderListEntity[29]" xsi:type="ns1:salesOrderListEntityArray">
				<item xsi:type="ns1:salesOrderListEntity">
					<increment_id xsi:type="xsd:string">100000048-9</increment_id>
					<store_id xsi:type="xsd:string">1</store_id>
					<created_at xsi:type="xsd:string">2020-11-12 16:58:08</created_at>
					<updated_at xsi:type="xsd:string">2020-11-12 16:59:15</updated_at>
					<customer_id xsi:type="xsd:string">18</customer_id>
					<discount_amount xsi:type="xsd:string">0.0000</discount_amount>
					<subtotal xsi:type="xsd:string">10.0000</subtotal>
					<grand_total xsi:type="xsd:string">10.0000</grand_total>
					<total_paid xsi:type="xsd:string">10.0000</total_paid>
					<total_qty_ordered xsi:type="xsd:string">1.0000</total_qty_ordered>
					<total_invoiced xsi:type="xsd:string">10.0000</total_invoiced>
					<base_discount_amount xsi:type="xsd:string">0.0000</base_discount_amount>
					<base_subtotal xsi:type="xsd:string">10.0000</base_subtotal>
					<base_grand_total xsi:type="xsd:string">10.0000</base_grand_total>
					<base_total_paid xsi:type="xsd:string">10.0000</base_total_paid>
					<base_total_invoiced xsi:type="xsd:string">10.0000</base_total_invoiced>
					<billing_address_id xsi:type="xsd:string">160</billing_address_id>
					<billing_firstname xsi:type="xsd:string">Alexsandro</billing_firstname>
					<billing_lastname xsi:type="xsd:string">Soulmkt</billing_lastname>
					<billing_name xsi:type="xsd:string">Alexsandro Soulmkt</billing_name>
					<weight xsi:type="xsd:string">0.0000</weight>
					<store_name xsi:type="xsd:string">Marketplace
Marketplace
PT:Português</store_name>
					<status xsi:type="xsd:string">processing</status>
					<state xsi:type="xsd:string">processing</state>
					<global_currency_code xsi:type="xsd:string">BRL</global_currency_code>
					<base_currency_code xsi:type="xsd:string">BRL</base_currency_code>
					<store_currency_code xsi:type="xsd:string">BRL</store_currency_code>
					<order_currency_code xsi:type="xsd:string">BRL</order_currency_code>
					<shipping_description xsi:type="xsd:string"></shipping_description>
					<customer_email xsi:type="xsd:string">[email protected]</customer_email>
					<customer_firstname xsi:type="xsd:string">Alexsandro</customer_firstname>
					<customer_lastname xsi:type="xsd:string">Soulmkt</customer_lastname>
					<quote_id xsi:type="xsd:string">0</quote_id>
					<is_virtual xsi:type="xsd:string">1</is_virtual>
					<customer_group_id xsi:type="xsd:string">5</customer_group_id>
					<customer_note_notify xsi:type="xsd:string">1</customer_note_notify>
					<customer_is_guest xsi:type="xsd:string">0</customer_is_guest>
					<order_id xsi:type="xsd:string">83</order_id>
					<protect_code xsi:type="xsd:string">a5b382</protect_code>
					<base_discount_invoiced xsi:type="xsd:string">0.0000</base_discount_invoiced>
					<base_shipping_invoiced xsi:type="xsd:string">0.0000</base_shipping_invoiced>
					<base_subtotal_invoiced xsi:type="xsd:string">10.0000</base_subtotal_invoiced>
					<base_tax_invoiced xsi:type="xsd:string">0.0000</base_tax_invoiced>
					<base_total_invoiced_cost xsi:type="xsd:string">0.0000</base_total_invoiced_cost>
					<discount_invoiced xsi:type="xsd:string">0.0000</discount_invoiced>
					<shipping_invoiced xsi:type="xsd:string">0.0000</shipping_invoiced>
					<subtotal_invoiced xsi:type="xsd:string">10.0000</subtotal_invoiced>
					<tax_invoiced xsi:type="xsd:string">0.0000</tax_invoiced>
					<paypal_ipn_customer_notified xsi:type="xsd:string">0</paypal_ipn_customer_notified>
					<base_subtotal_incl_tax xsi:type="xsd:string">10.0000</base_subtotal_incl_tax>
					<base_total_due xsi:type="xsd:string">0.0000</base_total_due>
					<subtotal_incl_tax xsi:type="xsd:string">10.0000</subtotal_incl_tax>
					<total_due xsi:type="xsd:string">0.0000</total_due>
					<customer_dob xsi:type="xsd:string">2000-01-01 00:00:00</customer_dob>
					<total_item_count xsi:type="xsd:string">1</total_item_count>
					<hidden_tax_invoiced xsi:type="xsd:string">0.0000</hidden_tax_invoiced>
					<base_hidden_tax_invoiced xsi:type="xsd:string">0.0000</base_hidden_tax_invoiced>
				</item>
			</result>
		</ns1:salesOrderListResponse>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.3. Actualización del estado de pedidos a ‘esperando_factura’ o ‘esperando_transporte’ #

(https://api.soulmkt.dev/sales_order.addComment.phtml)

3.3.1 Pedido con Factura

Utilizando el método de inclusión de comentarios, se debe forzar la actualización del estado del pedido al valor esperando_factura. De esta manera, los pedidos ya no aparecerán en la lista de pedidos pendientes.

XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddComment>
      <sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
      <orderIncrementId xsi:type="xsd:string">100000183-9</orderIncrementId>
      <status xsi:type="xsd:string">esperando_factura</status>
      <comment xsi:nil="true"/>
      <notify xsi:nil="true"/>
    </ns1:salesOrderAddComment>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Explicación de los Campos:

  • sessionId: Token de autenticación obtenido en el paso anterior.
  • orderIncrementId: Número del pedido a actualizar.
  • status: Valor del estado deseado (esperando_factura).

Respuesta:

Si la actualización se realiza correctamente, recibirás una respuesta como:

XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddCommentResponse>
      <result xsi:type="xsd:boolean">true</result>
    </ns1:salesOrderAddCommentResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.3.2 Pedido sin Factura

Si el pedido no tiene una factura, puede actualizarse al estado esperando_transporte. Así, el pedido dejará de estar en la lista de pendientes.

XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddComment>
      <sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
      <orderIncrementId xsi:type="xsd:string">100000183-9</orderIncrementId>
      <status xsi:type="xsd:string">esperando_transporte</status>
      <comment xsi:nil="true"/>
      <notify xsi:nil="true"/>
    </ns1:salesOrderAddComment>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Explicación de los Campos:

  • sessionId: Token de autenticación obtenido en el paso anterior.
  • orderIncrementId: Número del pedido a actualizar.
  • status: Valor del estado deseado (esperando_transporte).

Respuesta:

Si la actualización se realiza correctamente, recibirás una respuesta como:

XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddCommentResponse>
      <result xsi:type="xsd:boolean">true</result>
    </ns1:salesOrderAddCommentResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.4 Agregar datos de la Factura al pedido #

https://api.soulmkt.dev/sales_order_nf.create.phtml
Atención: Realiza este paso únicamente si el pedido cuenta con una factura fiscal.
De lo contrario, continúa con el paso 3.5.

Atención: Realiza este paso solamente si el pedido cuenta con factura. De lo contrario, pasa al paso 3.5.

En esta etapa, agregaremos todos los datos de la factura a los ítems del pedido.

Una vez que la factura sea informada para todos los ítems del pedido, el pedido será actualizado automáticamente al estado factura_emitida.

Ejemplo de Solicitud XML:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:Store"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:ns2="urn:OpenMage"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderNfCreate>
      <sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
      <orderIncrementId xsi:type="xsd:string">100000180-9</orderIncrementId>
      <chave_nf xsi:type="xsd:string">45454545464545446555654544646546565644444444</chave_nf>
      <link_nf xsi:type="xsd:string">https://www.nfe.fazenda.gov.br/portal/consultaRecaptcha.aspx</link_nf>
      <numero_nf xsi:type="xsd:int">174</numero_nf>
      <serie_nf xsi:type="xsd:int">1</serie_nf>
      <data_nf xsi:type="xsd:string">2023-01-01</data_nf>
      <hora_nf xsi:type="xsd:string">12:47</hora_nf>
      <items SOAP-ENC:arrayType="ns2:orderNfItem[1]" xsi:type="SOAP-ENC:Array">
        <item xsi:type="ns2:orderNfItem">
          <item_id xsi:type="xsd:string">305</item_id>
          <sku_marketplace xsi:type="xsd:string">bombacha-001</sku_marketplace>
        </item>
      </items>
    </ns1:salesOrderNfCreate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Explicación de los Campos:

  • sessionId: Token de autenticación obtenido anteriormente.
  • orderIncrementId: Número del pedido que será actualizado.
  • chave_nf: Clave de la factura.
  • link_nf: URL para consulta de la factura.
  • numero_nf: Número de la factura.
  • serie_nf: Serie de la factura.
  • data_nf: Fecha de emisión (formato YYYY-MM-DD).
  • hora_nf: Hora de emisión (formato HH:MM).
  • item_id: Identificador del ítem.
  • sku_marketplace: SKU del ítem en el marketplace.

Respuesta esperada:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:Store" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderNfCreateResponse>
      <result xsi:type="xsd:int">1</result>
    </ns1:salesOrderNfCreateResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.5 Ingresar los datos de rastreo del pedido #

https://api.soulmkt.dev/sales_order_shipment.create.phtml

En esta etapa informaremos los datos de envío del pedido.

Ejemplo de Solicitud XML:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderShipmentCreate>
      <sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
      <orderIncrementId xsi:type="xsd:string">100000180-9</orderIncrementId>
      <itemsQty SOAP-ENC:arrayType="ns1:orderItemIdQty[2]" xsi:type="SOAP-ENC:Array">
        <order_item_id>1</order_item_id>
        <qty>1</qty>
      </itemsQty>
      <comment xsi:type="xsd:string">Entrega</comment>
      <email xsi:nil="true"/>
      <includeComment xsi:nil="true"/>
    </ns1:salesOrderShipmentCreate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Explicación de los Campos:

  • sessionId: Token de autenticación obtenido anteriormente.
  • orderIncrementId: Número del pedido.
  • order_item_id: Identificador del ítem a ser enviado.
  • qty: Cantidad del ítem a ser enviada.
  • comment: Comentario sobre el envío (Ej: “Entrega”).
  • email: Campo opcional para enviar notificación por email.
  • includeComment: Indica si el comentario debe ser incluido en la notificación.

Respuesta esperada:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:OpenMage" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderShipmentCreateResponse>
      <shipmentIncrementId xsi:type="xsd:string">100000053</shipmentIncrementId>
    </ns1:salesOrderShipmentCreateResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.6 Actualizar el pedido al estado completo o esperando_confirmación #

3.6.1 Entrega del pedido con confirmación del cliente

Si el vendedor tiene una integración que le permita saber cuándo el pedido ha sido recibido por el cliente, puede actualizar el estado del pedido a esperando_confirmacion. Una vez que el cliente confirme la recepción, el pedido puede ser actualizado a completo.

⚠️ Para que esta opción funcione, es necesario verificar si el proceso de confirmación de recepción está habilitado en el marketplace. De lo contrario, proceda directamente al paso 3.6.2.

XML

<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddComment>
      <sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
      <orderIncrementId xsi:type="xsd:string">100000183-9</orderIncrementId>
      <status xsi:type="xsd:string">esperando_confirmacion</status>
      <comment xsi:nil="true"/>
      <notify xsi:nil="true"/>
    </ns1:salesOrderAddComment>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Explicación de los Campos:

  • sessionId: Token de autenticación obtenido anteriormente.
  • orderIncrementId: Número del pedido a actualizar.
  • status: Valor del nuevo estado (esperando_confirmacion).

Respuesta:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:OpenMage" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddCommentResponse>
      <result xsi:type="xsd:boolean">true</result>
    </ns1:salesOrderAddCommentResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Una vez que el cliente confirme la entrega, se debe actualizar el pedido al estado completo.

XML

<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddComment>
      <sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
      <orderIncrementId xsi:type="xsd:string">100000183-9</orderIncrementId>
      <status xsi:type="xsd:string">completo</status>
      <comment xsi:nil="true"/>
      <notify xsi:nil="true"/>
    </ns1:salesOrderAddComment>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Explicación de los Campos:

  • sessionId: Token de autenticación obtenido anteriormente.
  • orderIncrementId: Número del pedido a actualizar.
  • status: Valor del nuevo estado (completo).

Respuesta:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:OpenMage" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddCommentResponse>
      <result xsi:type="xsd:boolean">true</result>
    </ns1:salesOrderAddCommentResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.6.2 Entrega del pedido sin necesidad de confirmación del cliente

Si el vendedor no tiene habilitada la funcionalidad de confirmación por parte del cliente, puede actualizar directamente el pedido al estado completo.

XML

<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1="urn:OpenMage"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddComment>
      <sessionId xsi:type="xsd:string">1234567890abcdef1234567890abcdef</sessionId>
      <orderIncrementId xsi:type="xsd:string">100000183-9</orderIncrementId>
      <status xsi:type="xsd:string">completo</status>
      <comment xsi:nil="true"/>
      <notify xsi:nil="true"/>
    </ns1:salesOrderAddComment>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Explicación de los Campos:

  • sessionId: Token de autenticación obtenido anteriormente.
  • orderIncrementId: Número del pedido a actualizar.
  • status: Valor del nuevo estado (completo).

Respuesta:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:OpenMage" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:salesOrderAddCommentResponse>
      <result xsi:type="xsd:boolean">true</result>
    </ns1:salesOrderAddCommentResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

4. Consideraciones Finales

  • Pruebas: Realiza pruebas en un entorno de desarrollo antes de implementar en producción.
  • Errores Comunes: Verifica la validez del sessionId y los SKUs utilizados.
  • Herramientas: Postman u otras herramientas similares facilitarán el proceso.

Con esta guía, estarás preparado para consultar y actualizar el flujo de pedidos mediante las APIs V2 del Marketplace Soulmkt. Si tienes alguna duda, ponte en contacto con el soporte técnico.