Criação de Movimentação de Estoque

Criando Movimentação de Estoque (Inventário)

Este é o primeiro passo para criação do fluxo de produtos e monitoramento. Para efetuar a criação de uma movimentação de estoque, envie os dados necessários via POST na rota Url/segments/{segmentId}/stock-movements.

O SegmentID deverá ser informado, saiba mais em Login via API. O uso de seu Bearer Token também será necessário.

Criar Movimentação de Estoque

POST {Url}/segments/{segmentId}/stock-movements

Path Parameters

Name	Type	Description
segmentId	string	ID de Segmento
companies	string	ID das empresas que movimentarão os estoques

Request Body

Name	Type	Description
stockLocal*	string	ID do Local de Estoque
product*	string	ID do Produto
quantity*	number	Quantidade que deseja movimentar
type*	string	Tipo de movimentação (Entrada: in | Saída: out )
origin*	string	Origem da movimentação (Manual: manual | Catálogo: catalog | Máquina: device | Transferência: transfer )
note	string	Observação

201 Created

{
  "_id": "string",
  "createdAt": "2020-01-01T00:00:00Z",
  "updatedAt": "2020-01-01T00:00:00Z",
  "type": "in",
  "origin": "manual",
  "product": {
    "_id": "string",
    "createdAt": "2020-01-01T00:00:00Z",
    "updatedAt": "2020-01-01T00:00:00Z",
    "segment": "string",
    "sku": "string",
    "companies": [
      {
        "_id": "string",
        "createdAt": "2020-01-01T00:00:00Z",
        "updatedAt": "2020-01-01T00:00:00Z",
        "segment": "string",
        "type": "private",
        "document": "string",
        "name": "string",
        "tag": "string",
        "logoUrl": "string",
        "crtId": "string",
        "addresses": [
          {
            "_id": "string",
            "country": "string",
            "state": "string",
            "city": "string",
            "neighborhood": "string",
            "street": "string",
            "number": "string",
            "complement": "string",
            "postalCode": "string"
          }
        ],
        "contacts": [
          {
            "contact": "string",
            "type": "whatsapp"
          }
        ],
        "integration": {
          "praNotas": {
            "authorization": "string",
            "homologation": true,
            "certificate": "string",
            "status": "string",
            "count": 0,
            "serie": "string",
            "csc": "string",
            "cscId": "string"
          },
          "pagaRapido": {
            "authorization": "string",
            "subscription": "string"
          },
          "praSaques": {
            "token": "string"
          }
        },
        "activityBranch": {
          "_id": "string",
          "name": "string",
          "examples": "string",
          "value": "retail"
        },
        "stockSettings": {
          "stockLocalDevice": {
            "_id": "string",
            "createdAt": "2020-01-01T00:00:00Z",
            "updatedAt": "2020-01-01T00:00:00Z",
            "name": "string",
            "company": null,
            "acronym": "string",
            "segment": "string"
          },
          "stockLocalCatalog": {
            "_id": "string",
            "createdAt": "2020-01-01T00:00:00Z",
            "updatedAt": "2020-01-01T00:00:00Z",
            "name": "string",
            "company": null,
            "acronym": "string",
            "segment": "string"
          }
        }
      }
    ],
    "additionalCategories": [
      {
        "name": "string",
        "systemCode": "string",
        "minQuantity": 0,
        "maxQuantity": 0,
        "additionals": [
          {
            "name": "string",
            "description": "string",
            "systemCode": "string",
            "price": 0,
            "minQuantity": 0,
            "maxQuantity": 0,
            "status": "active"
          }
        ]
      }
    ],
    "categoryId": "string",
    "category": {
      "_id": "string",
      "createdAt": "2020-01-01T00:00:00Z",
      "updatedAt": "2020-01-01T00:00:00Z",
      "companies": [
        {
          "_id": "string",
          "createdAt": "2020-01-01T00:00:00Z",
          "updatedAt": "2020-01-01T00:00:00Z",
          "segment": "string",
          "type": "private",
          "document": "string",
          "name": "string",
          "tag": "string",
          "logoUrl": "string",
          "crtId": "string",
          "addresses": [
            {
              "_id": "string",
              "country": "string",
              "state": "string",
              "city": "string",
              "neighborhood": "string",
              "street": "string",
              "number": "string",
              "complement": "string",
              "postalCode": "string"
            }
          ],
          "contacts": [
            {
              "contact": "string",
              "type": "whatsapp"
            }
          ],
          "integration": {
            "praNotas": {
              "authorization": "string",
              "homologation": true,
              "certificate": "string",
              "status": "string",
              "count": 0,
              "serie": "string",
              "csc": "string",
              "cscId": "string"
            },
            "pagaRapido": {
              "authorization": "string",
              "subscription": "string"
            },
            "praSaques": {
              "token": "string"
            }
          },
          "activityBranch": {
            "_id": "string",
            "name": "string",
            "examples": "string",
            "value": "retail"
          },
          "stockSettings": {
            "stockLocalDevice": {
              "_id": "string",
              "createdAt": "2020-01-01T00:00:00Z",
              "updatedAt": "2020-01-01T00:00:00Z",
              "name": "string",
              "company": null,
              "acronym": "string",
              "segment": "string"
            },
            "stockLocalCatalog": {
              "_id": "string",
              "createdAt": "2020-01-01T00:00:00Z",
              "updatedAt": "2020-01-01T00:00:00Z",
              "name": "string",
              "company": null,
              "acronym": "string",
              "segment": "string"
            }
          }
        }
      ],
      "segment": "string",
      "name": "string",
      "systemCode": "string",
      "categoryId": "string",
      "iconUrl": "string",
      "subcategories": [],
      "status": "active",
      "salesChannelCategories": [
        {
          "appConfiguration": {},
          "salesChannelCategory": {
            "_id": "string",
            "createdAt": "2020-01-01T00:00:00Z",
            "updatedAt": "2020-01-01T00:00:00Z",
            "externalId": "string",
            "name": "string",
            "app": "string",
            "picture": "string",
            "previousCategories": [],
            "childrens": [],
            "customFields": []
          },
          "externalId": "string"
        }
      ]
    },
    "name": "string",
    "description": "string",
    "images": [
      "string"
    ],
    "price": 0,
    "printToken": true,
    "notPrintToken": true,
    "unitType": {
      "_id": "string",
      "name": "string",
      "abbreviation": "string"
    },
    "gtin": "string",
    "ncm": {
      "_id": "string",
      "code": "string",
      "description": "string",
      "cestId": "string"
    },
    "cest": {
      "_id": "string",
      "name": "string",
      "code": "string"
    },
    "taxationRule": {
      "_id": "string",
      "createdAt": "2020-01-01T00:00:00Z",
      "updatedAt": "2020-01-01T00:00:00Z",
      "name": "string",
      "segment": "string",
      "originId": "string",
      "cfopId": "string",
      "cstIcmsId": "string",
      "cstPisId": "string",
      "cstCofinsId": "string",
      "cstIpiId": "string",
      "cstIssId": "string",
      "aliqConfins": 0,
      "aliqPis": 0,
      "aliquoteCgsn53": 0,
      "csll": 0,
      "inss": 0,
      "ir": 0,
      "iss": 0,
      "mvaPerState": [
        "string"
      ],
      "tributes": [
        "string"
      ],
      "status": "active"
    },
    "productEnvironments": [
      "string"
    ],
    "picture": "string",
    "status": "active",
    "stockLocals": [
      {
        "_id": "string",
        "stockLocal": "string",
        "minQuantity": 0,
        "maxQuantity": 0
      }
    ],
    "dimensions": {
      "width": 0,
      "height": 0,
      "depth": 0,
      "weight": 0
    },
    "salesChannels": [
      {
        "company": {
          "_id": "string",
          "createdAt": "2020-01-01T00:00:00Z",
          "updatedAt": "2020-01-01T00:00:00Z",
          "segment": "string",
          "type": "private",
          "document": "string",
          "name": "string",
          "tag": "string",
          "logoUrl": "string",
          "crtId": "string",
          "addresses": [
            {
              "_id": "string",
              "country": "string",
              "state": "string",
              "city": "string",
              "neighborhood": "string",
              "street": "string",
              "number": "string",
              "complement": "string",
              "postalCode": "string"
            }
          ],
          "contacts": [
            {
              "contact": "string",
              "type": "whatsapp"
            }
          ],
          "integration": {
            "praNotas": {
              "authorization": "string",
              "homologation": true,
              "certificate": "string",
              "status": "string",
              "count": 0,
              "serie": "string",
              "csc": "string",
              "cscId": "string"
            },
            "pagaRapido": {
              "authorization": "string",
              "subscription": "string"
            },
            "praSaques": {
              "token": "string"
            }
          },
          "activityBranch": {
            "_id": "string",
            "name": "string",
            "examples": "string",
            "value": "retail"
          },
          "stockSettings": {
            "stockLocalDevice": {
              "_id": "string",
              "createdAt": "2020-01-01T00:00:00Z",
              "updatedAt": "2020-01-01T00:00:00Z",
              "name": "string",
              "company": null,
              "acronym": "string",
              "segment": "string"
            },
            "stockLocalCatalog": {
              "_id": "string",
              "createdAt": "2020-01-01T00:00:00Z",
              "updatedAt": "2020-01-01T00:00:00Z",
              "name": "string",
              "company": null,
              "acronym": "string",
              "segment": "string"
            }
          }
        },
        "app": {},
        "status": "active",
        "price": 0,
        "promotionalPrice": 0
      }
    ],
    "pictures": [
      "string"
    ],
    "brand": {
      "_id": "string",
      "name": "string",
      "companies": [
        {
          "_id": "string",
          "name": "string"
        }
      ],
      "picture": "string",
      "status": "active"
    },
    "stocks": [
      {}
    ]
  },
  "stockLocal": {
    "_id": "string",
    "createdAt": "2020-01-01T00:00:00Z",
    "updatedAt": "2020-01-01T00:00:00Z",
    "name": "string",
    "company": null,
    "acronym": "string",
    "segment": "string"
  },
  "user": {
    "_id": "string",
    "createdAt": "2020-01-01T00:00:00Z",
    "updatedAt": "2020-01-01T00:00:00Z",
    "name": "string",
    "avatarUrl": "string",
    "phoneNumber": "string",
    "document": "string",
    "email": "string",
    "status": "active",
    "access": [
      {
        "segment": "string",
        "companies": [
          "string"
        ],
        "group": "string"
      }
    ],
    "screensJourneyConfirmations": [
      "string"
    ],
    "hasConfirmedPageJourneySecondStep": true
  },
  "quantity": 0,
  "currentStock": 0,
  "note": "string"
}

400 Verifique os dados inseridos e tente novamente.

[]

401 Verifique o Bearer Token utilizado e tente novamente.

[]

404 Verifique a rota e método utilizado e tente novamente.

Caso a requisição esteja correta, o código 201 Created será retornado. Prossiga para as próximas sessões para entender mais sobre nossas funções disponíveis.

Outros Erros: Caso sejam retornados outros erros, favor entrar em contato com o time de integração.