> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.quivo.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Save seller logo
> Attach an uploaded image as the seller's logo. First call POST /sellers/{id}/logos/upload to get an upload URL and a file key, upload the image to that URL, then call this endpoint with the file key and MIME type.
## OpenAPI
````yaml /openapi.json post /sellers/{id}/logos
openapi: 3.0.1
info:
title: Connector
version: '1.0'
description: Manage orders, articles, inbounds, shipments and returns in The Connector.
contact:
name: Quivo Support
email: support@quivo.co
url: https://quivo.co
license:
name: Proprietary
url: https://quivo.co/terms
termsOfService: https://quivo.co/terms
servers:
- url: https://api.quivo.co/v2
description: Production API server for Quivo Connector
security:
- bearerAuth: []
tags:
- name: addresses
description: Manage stored addresses in the seller's address book
- name: articles
description: Create and manage product articles
- name: bundles
description: Manage product bundles
- name: carriers
description: Get carrier information
- name: contacts
description: Manage contact information
- name: countries
description: Get country information
- name: currencies
description: Get currency information
- name: customerInquiries
description: Manage customer inquiries
- name: files
description: Manage file uploads and downloads
- name: fulfillmentPlans
description: Manage fulfillment plans
- name: inbounds
description: Manage inbound shipments
- name: invoices
description: List and download invoices
- name: items
description: Monitor and manage inventory items
- name: languages
description: Get language information
- name: orders
description: Create and manage fulfillment orders
- name: ping
description: Health check endpoint
- name: returnApp
description: Manage return applications
- name: returnLinks
description: Manage return links
- name: returns
description: Manage returns
- name: sellers
description: Get seller information
- name: shipments
description: Book and manage shipments
- name: shippingServiceGroups
description: Get shipping service groups
- name: shopOrders
description: Manage shop orders
- name: shops
description: Manage shops
- name: status
description: Get system status
- name: storedAddresses
description: Manage stored addresses
- name: subscriptionPackages
description: Manage subscription packages
- name: subscriptions
description: Manage webhook subscriptions
- name: transports
description: Manage transport services
- name: warehouses
description: Get warehouse information
paths:
/sellers/{id}/logos:
post:
tags:
- sellers
summary: Save seller logo
description: >-
Attach an uploaded image as the seller's logo. First call POST
/sellers/{id}/logos/upload to get an upload URL and a file key, upload
the image to that URL, then call this endpoint with the file key and
MIME type.
operationId: sellersPostLogo
parameters:
- name: id
in: path
description: Id of the seller to which the logo should be added
required: true
schema:
type: integer
format: int64
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SellerLogoPost'
required: false
description: The file key and MIME type of the uploaded logo image
responses:
'200':
description: Returns the seller with the new logo.
content:
application/json:
schema:
$ref: '#/components/schemas/SellerGet'
'400':
description: >-
Bad request - the request payload is invalid, missing required
fields, or contains invalid data.
'401':
description: >-
Unauthorized - authentication credentials are missing, invalid, or
expired.
'404':
description: >-
Not found - the requested resource does not exist or is not
accessible.
'500':
description: Internal server error - an unexpected error occurred on the server.
components:
schemas:
SellerLogoPost:
type: object
properties:
fileKey:
type: string
description: Identifier of the image file to be saved.
mimeType:
type: string
description: Mime type of the image file
description: >-
Request payload for creating or updating a seller logo. Contains logo
image data and metadata for associating visual branding with a seller
account.
SellerGet:
required:
- sellerAddress
- sendToEmail
- subscriptionPackage
type: object
properties:
name:
type: string
description: The name of the seller
usesWarehouseSku:
type: boolean
description: >-
If true, SKUs in this seller's orders are read as warehouse SKUs. If
false, they are read as the seller's own SKUs.
warehouseId:
type: integer
format: int64
description: The unique identifier for the warehouse
companyName:
maxLength: 50
minLength: 0
type: string
description: Company name.
Necessary for VAT Registration Number
sendToEmail:
maxLength: 80
minLength: 0
type: string
description: E-Mail address to send invoices.
sellerServices:
type: array
items:
type: string
description: Seller identifier or information
pixiSellerIdentifier:
maxLength: 5
minLength: 0
type: string
description: SellerIdentifier used in Pixi
Necessary for Pixi sellers
pixiArticlePrefix:
maxLength: 10
minLength: 0
type: string
description: ArticlePrefix used for Pixi articles
Necessary for Pixi sellers
pixiManualOrderPrefix:
maxLength: 10
minLength: 0
type: string
description: >-
OrderPrefix used for Pixi orders created manually
Necessary for
Pixi sellers
allowInboundOverReceiving:
type: boolean
description: >-
Optional value indicating if seller can over receive more than
announced during inbounds.
Default value is true.
allowReturnOverReceiving:
type: boolean
description: >-
Optional value indicating if seller can receive more than announced
during returns.
Default value is true.
lottableIdRequired:
type: boolean
description: >-
Optional value indicating if seller requires to replace lot no. with
lottable ID.
Default value is false.
sendToCcEmail:
maxLength: 80
minLength: 0
type: string
description: CC E-Mail address to send invoices.
This field is optional.
voecNumber:
maxLength: 20
minLength: 0
type: string
description: VOEC Number Norway.
vatNumber:
maxLength: 20
minLength: 0
type: string
description: VAT Registration Number.
vatNumberRequired:
type: boolean
description: Optional value indicating whether the VAT number is required or not.
homePage:
maxLength: 80
minLength: 0
type: string
description: Home page url.
This field is optional.
useArticleBaseData:
type: boolean
description: >-
Optional value indicating whether the article data is used as base
data when some fields are missing in shop system.
By default
article data is not used as base data.
eoriNumber:
maxLength: 35
minLength: 0
type: string
description: EORI number.
This field is optional.
sellerAddress:
$ref: '#/components/schemas/SellerAddress'
vatNumberPerCountry:
type: object
additionalProperties:
type: string
description: Vat numbers per country.
This field is optional.
eoriNumberPerCountry:
type: object
additionalProperties:
type: string
description: Eori numbers per country.
This field is optional.
subscriptionPackage:
type: string
description: Subscription package for this Seller
enum:
- RISING_STAR
- STELLAR_EXPLORER
- FULFILLED_LEGEND
- WITHOUT_PACKAGE
- SEND_IT_YOURSELF
- CUSTOMIZED
sellerLogo:
$ref: '#/components/schemas/Link'
exportedAt:
type: string
format: date-time
description: The exported at timestamp
managingGroup:
type: string
enum:
- QUIVO
- GWC
description: 'The managing group. Possible values: QUIVO, GWC'
customerCareSystem:
type: string
description: Customer care system used for this Seller.
enum:
- SALESFORCE
- ZENDESK
trackingEnabled:
type: boolean
description: Indicates whether tracking is enabled
trackingEnabledCarriers:
uniqueItems: true
type: array
description: >-
Carriers for which tracking events are enabled for all shipments of
this seller.
items:
type: string
enum:
- DHL_PARCEL
- DHL_PARCEL_UK
- DHL_EXPRESS
- DPD
- GLS
- GO_EXPRESS
- POST_AT
- POST_AT_LETTER
- USPS
- ONTRAC
- UPS
- LASERSHIP
- FEDEX
- POST_DE
- ROYAL_MAIL
- SWISS_POST
- EVRI
- EVRI_DIRECT
- CARGO_BOARD
- COLISSIMO
- DPD_FRANCE
- DPD_DE
- LETTRE_SUIVIE
- TNT_EXPRESS
- DELIVENGO
- MONDIAL_RELAY
- PARCEL_ONE
- BARTOLINI
- INSTABEE
- GEODIS
- AMAZON
- COLIS_PRIVE
- GWC
- ARAMEX
- OTO
- SEVEN_SENDERS
- UNTRACKED
dimensionsRequired:
type: boolean
description: Indicates whether dimensions is required
exportTrackingEventToShop:
type: boolean
allowPartialDefault:
type: boolean
description: Default for the allowPartial flag of new orders of this seller.
customAttributes:
type: object
additionalProperties:
type: string
description: Optional value for custom attributes of article.
example: '{"attr1":"val1"}'
description: >-
Complete seller account information. Contains seller details,
configuration, subscription information, and account settings.
SellerAddress:
required:
- city
- countryIso2
- email
- name
- phone
type: object
properties:
name:
maxLength: 50
minLength: 0
type: string
description: Contact name.
Usually this is the first and last name.
phone:
maxLength: 30
minLength: 0
type: string
description: Phone number.
email:
maxLength: 80
minLength: 0
type: string
description: E-Mail address.
zip:
maxLength: 29
minLength: 0
type: string
description: >-
ZIP Code.
The ZIP code is optional for some countries, but
required for most.
city:
maxLength: 30
minLength: 0
type: string
description: City.
The city should always be specified.
state:
type: string
description: >-
State.
This is not required for most countries, but required in
some (eg: United States).
countryIso2:
type: string
description: Country.
The country should always be specified.
street:
maxLength: 50
minLength: 0
type: string
description: Street (or Address Line 1).
This field is optional.
street2:
maxLength: 50
minLength: 0
type: string
description: Street (or Address Line 2).
This field is optional.
description: 'The '
Link:
type: object
properties:
link:
type: string
description: Link or URL reference
description: URL link reference. Contains link URL and optional metadata.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Access token from POST /v2/oauth2/token, requested with an API
credential. See https://api-docs.quivo.co/api-reference/authentication.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.