> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mervii.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Door - Centre

> **Home Pickup to Cenntre (Hub)**

**The** endpoint is used to calculate the price for delivering items from a pickup origin (home pickup) to one or more destinations, with a specific centre for the destination.



## OpenAPI

````yaml beta/en/api/beta.yaml post /price/door-centre
openapi: 3.0.3
info:
  title: Introduction to the Mervii Open API
  description: >-
    # Introduction to the Mervii Open API


    The Mervii Open API offers secure, scalable, and seamless integration with
    our cutting-edge logistics, delivery, and payment systems. Designed with
    both developers and enterprises in mind, this API enables you to embed
    Mervii’s advanced capabilities directly into your applications. Whether you
    aim to implement real-time tracking, streamline complex logistics
    operations, or integrate secure payment processing, our comprehensive suite
    of endpoints provides the flexibility and performance necessary to support
    your digital transformation initiatives.


    This documentation serves as your detailed guide for integration, featuring
    in-depth technical explanations, practical code examples, and industry best
    practices to ensure a smooth and efficient implementation. Key features
    include:


    - **Robust Logistics Management:** Handle intricate logistics processes—from
    parcel tracking to fleet management—with ease.
        
    - **Real-time Delivery Services:** Incorporate dynamic delivery options that
    offer instant tracking and status updates.
        
    - **Secure Payment Processing:** Enable swift and secure transactions across
    a variety of payment methods.
        

    _Please note:_ The Mervii Open API is currently in public beta. For
    expedited access or further technical support, kindly contact us at
    [partners@mervii.com](https://null) or
    [developers@mervii.com](https://null).


    Explore our documentation to unlock the full potential of Mervii’s
    innovative solutions and elevate your application’s capabilities.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.mervii.com/beta
security: []
tags:
  - name: prices
    description: >-
      ## Prices


      These endpoints gives the partners access to check the price quoation for
      the delivery before make a delivery request.


      > **Recommendation**  

      _We strongly encourage our partners to get the price to determine the
      total amount of money Mervii will charge for each delivery request._
  - name: parcels
    description: >-
      # Parcel


      These service contain two segment


      - CitySwift (Intral city)
          
      - FlexFlow (Inter city or inter state)
          
      # CitySwift (Intral city)

      > CitySwift is an instant delivery within a city; We aim to fulfill this
      request with an hour.

      ##### Suitable For

      - Food delivery

      - Grocesery store 

      - Resturant 

      - Supper-market 

      - and order need to fulfill instantly within a city.


      # FlexFlow (Inter city or inter state)

      > FlexFlow (Inter city or inter state) is a schedule delivery within a
      city, inter-state or inter city with a flexible flexibility, FlexFlow
      comes with a variant flexibility; Offering Pickup and Drop-off center or
      Hub, Home delivery and Home pickup (ends-ends services).

      ##### Suitable For

      - Inter-state delivery

      - Hub pickup and drop-off 

      - Home delivery and Home pickup
  - name: CitySwift (Intral city)
    description: >-
      # Intral-city

      This endpoint allow partners to request for delivery fulfilment within
      cities. This type of request are expected to be fulfiled within short
      period of time i.e. *Same day delivery*.


      This type of request suitable for resturances and gloceries partners.


      > ## Good to Know

      > This request only available with cities, i.e. partners can only make
      request for the address with cities for pickup and delivery.


      - e.g sender and receiver address are within a city.
  - name: FlexFlow
    description: >-
      # Logistics services

      These endpoint in the segment contains different instruction to fulfil a
      logistics request.


      - **Door to Door** : This types of request gives us instruction to handle
      you logistics end - end i.e. *Home delivery*. Our delivery personnel come
      to pickup at a specified place  and delivered to the receivers specified
      place using Latitude and longitude.



      - **Centre to Centre** : This types of request gives us instruction to our
      personnel to pickup your item at our specified centre and deliver it to
      our specified centre.  

      > ## Note

      > Sender are expected to take the items to our centre and receiver need to
      come to our centre to pick-up the items.




      - ** Centre to Door** : This types of request gives us instruction to our
      personnel to pickup your items at our specified centre and the deliver it
      to the receivers specified address i.e *Home delivery*

      > ## Note

      > Sender are expected to take the items to our centre.




      - ** Door to Centre** : This types of request gives us instruction to our
      personnel to pickup your items at sender specified address i.e. *Home
      pickup* and the deliver it to the receivers specified centre.

      > ## Note

      > Receiver need to come to our specified pickup centre to pick-up the
      items.
       
  - name: Utils
    description: >-
      # Utils endpoints

      These endpoint return mervii utils data and variable specified by Mervii
      to ensure request integrities.

      - States and codes

      - Pickup and drop-off centres

      - Weight variables and codes
paths:
  /price/door-centre:
    post:
      tags:
        - prices
      summary: Door - Centre
      description: >-
        **Home Pickup to Cenntre (Hub)**


        **The** endpoint is used to calculate the price for delivering items
        from a pickup origin (home pickup) to one or more destinations, with a
        specific centre for the destination.
      operationId: doorCentre
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                destinations:
                  type: array
                  items:
                    type: object
                    properties:
                      addresss:
                        type: string
                        example: ''
                      centre_code:
                        type: string
                        example: ''
                      country_code:
                        type: string
                        example: ''
                      item_weight:
                        type: number
                        example: 1
                      state_code:
                        type: string
                        example: ''
                  example:
                    - addresss: ''
                      centre_code: ''
                      country_code: ''
                      item_weight: 1
                      state_code: ''
                pickup_origin:
                  type: object
                  properties:
                    city:
                      type: string
                      example: ''
                    country_code:
                      type: string
                      example: NG
                    region:
                      type: object
                      properties:
                        latitude:
                          type: number
                          example: 7.427026700000001
                        longitude:
                          type: number
                          example: 3.8900142
                    state_code:
                      type: string
                      example: LA
            examples:
              Door - Centre:
                value:
                  destinations:
                    - addresss: ''
                      centre_code: ''
                      country_code: ''
                      item_weight: 1
                      state_code: ''
                  pickup_origin:
                    city: ''
                    country_code: NG
                    region:
                      latitude: 7.427026700000001
                      longitude: 3.8900142
                    state_code: LA
      responses:
        '200':
          description: success
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-cache, private
            Connection:
              schema:
                type: string
                example: close
            Date:
              schema:
                type: string
                example: Tue, 08 Oct 2024 20:13:47 GMT
            Host:
              schema:
                type: string
                example: api.localhost:8000
            Vary:
              schema:
                type: string
                example: Origin
            X-Powered-By:
              schema:
                type: string
                example: PHP/8.3.11
            X-RateLimit-Limit:
              schema:
                type: string
                example: '60'
            X-RateLimit-Remaining:
              schema:
                type: string
                example: '59'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      destinations:
                        type: array
                        items:
                          type: object
                          properties:
                            addresss:
                              nullable: true
                              example: null
                            centre_code:
                              type: string
                              example: ibadan-sango
                            country_code:
                              nullable: true
                              example: null
                            dropoff_centre:
                              type: object
                              properties:
                                centre_code:
                                  type: string
                                  example: ibadan-sango
                                centre_name:
                                  type: string
                                  example: Sango Ibadan
                            item_weight:
                              type: number
                              example: 1
                            price:
                              type: object
                              properties:
                                amount:
                                  type: number
                                  example: 3000.98
                                amount_payable:
                                  type: number
                                  example: 3000.98
                                discount_amount:
                                  type: number
                                  example: 0
                                discount_description:
                                  type: string
                                  example: 0% discount
                                discount_type:
                                  type: string
                                  example: Percetage
                                distance:
                                  type: string
                                  example: ' Kilometres to the drop off center '
                                duration:
                                  type: string
                                  example: 1-4 days
                            state_code:
                              nullable: true
                              example: null
                            weight:
                              type: string
                              example: '1'
                        example:
                          - addresss: null
                            centre_code: ibadan-sango
                            country_code: null
                            dropoff_centre:
                              centre_code: ibadan-sango
                              centre_name: Sango Ibadan
                            item_weight: 1
                            price:
                              amount: 3000.98
                              amount_payable: 3000.98
                              discount_amount: 0
                              discount_description: 0% discount
                              discount_type: Percetage
                              distance: ' Kilometres to the drop off center '
                              duration: 1-4 days
                            state_code: null
                            weight: '1'
                      discount_description:
                        type: string
                        example: 0% discount
                      discount_type:
                        type: string
                        example: Percetage
                      pickup_origin:
                        type: object
                        properties:
                          city:
                            nullable: true
                            example: null
                          country_code:
                            type: string
                            example: NG
                          pickup_centre:
                            type: object
                            properties:
                              centre_code:
                                type: string
                                example: lagos-ojodu-berger
                              centre_name:
                                type: string
                                example: Ojodu Berger Lagos
                          region:
                            type: object
                            properties:
                              latitude:
                                type: number
                                example: 7.427026700000001
                              longitude:
                                type: number
                                example: 3.8900142
                          state_code:
                            type: string
                            example: LA
                      total_amount:
                        type: number
                        example: 11192.940875080363
                      total_amount_payable:
                        type: number
                        example: 11192.940875080363
                      total_discount_amount:
                        type: number
                        example: 0
                  message:
                    type: string
                    example: get price
                  status:
                    type: boolean
                    example: true
              examples:
                success:
                  value:
                    data:
                      destinations:
                        - addresss: null
                          centre_code: ibadan-sango
                          country_code: null
                          dropoff_centre:
                            centre_code: ibadan-sango
                            centre_name: Sango Ibadan
                          item_weight: 1
                          price:
                            amount: 3000.98
                            amount_payable: 3000.98
                            discount_amount: 0
                            discount_description: 0% discount
                            discount_type: Percetage
                            distance: ' Kilometres to the drop off center '
                            duration: 1-4 days
                          state_code: null
                          weight: '1'
                      discount_description: 0% discount
                      discount_type: Percetage
                      pickup_origin:
                        city: null
                        country_code: NG
                        pickup_centre:
                          centre_code: lagos-ojodu-berger
                          centre_name: Ojodu Berger Lagos
                        region:
                          latitude: 7.427026700000001
                          longitude: 3.8900142
                        state_code: LA
                      total_amount: 11192.940875080363
                      total_amount_payable: 11192.940875080363
                      total_discount_amount: 0
                    message: get price
                    status: true
        '400':
          description: Bad request
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-cache, private
            Connection:
              schema:
                type: string
                example: close
            Date:
              schema:
                type: string
                example: Tue, 08 Oct 2024 20:14:18 GMT
            Host:
              schema:
                type: string
                example: api.localhost:8000
            Vary:
              schema:
                type: string
                example: Origin
            X-Powered-By:
              schema:
                type: string
                example: PHP/8.3.11
            X-RateLimit-Limit:
              schema:
                type: string
                example: '60'
            X-RateLimit-Remaining:
              schema:
                type: string
                example: '58'
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The destinations.0.centre_code field is required.
                  status:
                    type: boolean
                    example: false
              examples:
                Bad request:
                  value:
                    message: The destinations.0.centre_code field is required.
                    status: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````