Acuse del Bien y/o Prestación del Servicio

Acuse del Bien y/o Prestación del Servicio#

El acuse del bien y/o prestación del servicio es la notificación que confirma que el bien ha sido entregado o que el servicio ha sido prestado exitosamente.

Para consumir la API, es importante considerar el entorno en el que se trabajará. SOVOS Saphety cuenta con dos ambientes, especificados en el apartado de Entornos.

Consumo del método para realizar acuse del bien y/o prestación del servicio.#

acuseBien

El Verbo Http (acción) que se utiliza para la consulta de este formato es:

POST

El método que se utiliza para la consulta de este formato es:

    /v2/{virtualOperator}/inbounddocuments/{documentId}/goodsreceived

Para esta petición se requiere como parámetro el alias de su operador virtual y el codigo de la compañia companyId.

Parametro virtualOperator

Recuerde reemplazar en el método el parámetro {virtualOperator} con el alias de su operador virtual en minúsculas, por defecto el alias es “saphety”.

Parametro id

Recuerde reemplazar en el método el parámetro {documentId} con el codigo identificador unico del documento recibido.

Body#

Estructura del mensaje JSON para realizar el acuse del bien y/o servicio.#

A continuación encontrará la estructura base definida por Saphety para realizar el acuse del bien y/o servicio.

JSON (DTO)
{
  "FirstName": "Pepito",
  "FamilyName": "Perez",
  "JobTitle": "Facturador Electrónico",
  "OrganizationDepartment": "Contabilidad",
  "Identification": {
    "DocumentNumber": "80844005",
    "DocumentType": "NIT",
    "CountryCode": "CO",
    "CheckDigit": "1"
  }
}

Respuesta#

{
   "IsValid":true,
   "Warnings":[],
   "Errors":[],
   "ResultData":true,
   "ResultCode":200
}

{
    "IsValid": false,
    "Warnings": [],
    "Errors": [
        {
            "Field": null,
            "Code": "UnauthorizedUserToExecuteOperation",
            "Description": null,
            "ExplanationValues": []
        }
    ],
    "ResultData": false,
    "ResultCode": 400
}

Referencia: Swagger#

Para obtener más información, puedes consultar la documentación del API de SOVOS Saphety en Swagger. A continuación, se indican los enlaces según el ambiente: